triflux 3.2.0-dev.1 → 3.2.0-dev.10

package/hub/team/pane.mjs

@@ -1,101 +1,138 @@
-// hub/team/pane.mjs — pane별 CLI 실행 + stdin 주입
-// 의존성: child_process, fs, os, path (Node.js 내장)만 사용
-import { execSync } from "node:child_process";
-import { writeFileSync, unlinkSync, mkdirSync } from "node:fs";
-import { join } from "node:path";
-import { tmpdir } from "node:os";
-import { detectMultiplexer } from "./session.mjs";
-
-/** Windows 경로를 MSYS2/Git Bash tmux용 POSIX 경로로 변환 */
-function toTmuxPath(p) {
-  if (process.platform !== "win32") return p;
-  // C:\Users\... → /c/Users/...
-  return p.replace(/\\/g, "/").replace(/^([A-Za-z]):/, (_, d) => `/${d.toLowerCase()}`);
-}
-
-/** tmux 커맨드 실행 (session.mjs와 동일 패턴) */
-function tmux(args, opts = {}) {
-  const mux = detectMultiplexer();
-  if (!mux) throw new Error("tmux 미발견");
-  const prefix = mux === "wsl-tmux" ? "wsl tmux" : "tmux";
-  const result = execSync(`${prefix} ${args}`, {
-    encoding: "utf8",
-    timeout: 10000,
-    stdio: ["pipe", "pipe", "pipe"],
-    ...opts,
-  });
-  return result != null ? result.trim() : "";
-}
-
-/**
- * CLI 에이전트 시작 커맨드 생성
- * @param {'codex'|'gemini'|'claude'} cli
- * @returns {string} 실행할 셸 커맨드
- */
-export function buildCliCommand(cli) {
-  switch (cli) {
-    case "codex":
-      // interactive REPL 진입 — MCP는 ~/.codex/config.json에 사전 등록
-      return "codex";
-    case "gemini":
-      // interactive 모드 — MCP는 ~/.gemini/settings.json에 사전 등록
-      return "gemini";
-    case "claude":
-      // interactive 모드
-      return "claude";
-    default:
-      return cli; // 커스텀 CLI 허용
-  }
-}
-
-/**
- * tmux 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`);
-}
-
-/**
- * pane에 프롬프트 주입 (load-buffer + paste-buffer 방식)
- * 멀티라인 + 특수문자 안전, 크기 제한 없음
- * @param {string} target — 예: tfx-team-abc:0.1
- * @param {string} prompt — 주입할 텍스트
- */
-export function injectPrompt(target, prompt) {
-  // 임시 파일에 프롬프트 저장
-  const tmpDir = join(tmpdir(), "tfx-team");
-  mkdirSync(tmpDir, { recursive: true });
-
-  // pane ID를 파일명에 포함 (충돌 방지)
-  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 {
-      unlinkSync(tmpFile);
-    } catch {
-      // 정리 실패 무시
-    }
-  }
-}
-
-/**
- * pane에 키 입력 전송
- * @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}`);
-}
+// 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";
+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];
+
+  // wsl tmux는 /mnt/c/... 경로를 사용
+  if (mux === "wsl-tmux") {
+    return `/mnt/${drive}/${rest}`;
+  }
+
+  // Git Bash/MSYS tmux는 /c/... 경로를 사용
+  return `/${drive}/${rest}`;
+}
+
+/** 멀티플렉서 커맨드 실행 (session.mjs와 동일 패턴) */
+function muxExec(args, opts = {}) {
+  const exec = detectMultiplexer() === "psmux" ? psmuxExec : tmuxExec;
+  return exec(args, {
+    encoding: "utf8",
+    timeout: 10000,
+    stdio: ["pipe", "pipe", "pipe"],
+    ...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";
+    case "gemini":
+      // interactive 모드 — MCP는 ~/.gemini/settings.json에 사전 등록
+      return "gemini";
+    case "claude":
+      // interactive 모드
+      return "claude";
+    default:
+      return cli; // 커스텀 CLI 허용
+  }
+}
+
+/**
+ * pane에 CLI 시작
+ * @param {string} target — 예: tfx-multi-abc:0.1
+ * @param {string} command — 실행할 커맨드
+ */
+export function startCliInPane(target, command) {
+  // CLI 시작도 buffer paste를 재사용해 셸/플랫폼별 quoting 차이를 제거한다.
+  injectPrompt(target, command);
+}
+
+/**
+ * pane에 프롬프트 주입 (load-buffer + paste-buffer 방식)
+ * 멀티라인 + 특수문자 안전, 크기 제한 없음
+ * @param {string} target — 예: tfx-multi-abc:0.1
+ * @param {string} prompt — 주입할 텍스트
+ */
+export function injectPrompt(target, prompt) {
+  // 임시 파일에 프롬프트 저장
+  const tmpDir = join(tmpdir(), "tfx-multi");
+  mkdirSync(tmpDir, { recursive: true });
+
+  // pane ID를 파일명에 포함 (충돌 방지)
+  const safeTarget = target.replace(/[:.]/g, "-");
+  const tmpFile = join(tmpDir, `prompt-${safeTarget}-${Date.now()}.txt`);
+
+  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);
+    } catch {
+      // 정리 실패 무시
+    }
+  }
+}
+
+/**
+ * pane에 키 입력 전송
+ * @param {string} target — 예: tfx-multi-abc:0.1
+ * @param {string} keys — tmux 키 표현 (예: 'C-c', 'Enter')
+ */
+export function sendKeys(target, keys) {
+  muxExec(`send-keys -t ${target} ${keys}`);
+}

package/hub/team/psmux.mjs

@@ -0,0 +1,297 @@
+// hub/team/psmux.mjs — Windows psmux 세션/키바인딩/캡처 관리
+// 의존성: child_process (Node.js 내장)만 사용
+import { execSync, spawnSync } from "node:child_process";
+
+const PSMUX_BIN = process.env.PSMUX_BIN || "psmux";
+
+function quoteArg(value) {
+  const str = String(value);
+  if (!/[\s"]/u.test(str)) return str;
+  return `"${str.replace(/"/g, '\\"')}"`;
+}
+
+function toPaneTitle(index) {
+  return index === 0 ? "lead" : `worker-${index}`;
+}
+
+function parsePaneList(output) {
+  return output
+    .split("\n")
+    .map((line) => line.trim())
+    .filter(Boolean)
+    .map((line) => {
+      const [indexText, target] = line.split("\t");
+      return {
+        index: parseInt(indexText, 10),
+        target: target?.trim() || "",
+      };
+    })
+    .filter((entry) => Number.isFinite(entry.index) && entry.target)
+    .sort((a, b) => a.index - b.index)
+    .map((entry) => entry.target);
+}
+
+function parseSessionSummaries(output) {
+  return output
+    .split("\n")
+    .map((line) => line.trim())
+    .filter(Boolean)
+    .map((line) => {
+      const colonIndex = line.indexOf(":");
+      if (colonIndex === -1) {
+        return null;
+      }
+
+      const sessionName = line.slice(0, colonIndex).trim();
+      const flags = [...line.matchAll(/\(([^)]*)\)/g)].map((match) => match[1]).join(", ");
+      const attachedMatch = flags.match(/(\d+)\s+attached/);
+      const attachedCount = attachedMatch
+        ? parseInt(attachedMatch[1], 10)
+        : /\battached\b/.test(flags)
+          ? 1
+          : 0;
+
+      return sessionName
+        ? { sessionName, attachedCount }
+        : null;
+    })
+    .filter(Boolean);
+}
+
+function collectSessionPanes(sessionName) {
+  const output = psmuxExec(
+    `list-panes -t ${quoteArg(`${sessionName}:0`)} -F "#{pane_index}\t#{session_name}:#{window_index}.#{pane_index}"`
+  );
+  return parsePaneList(output);
+}
+
+function psmux(args, opts = {}) {
+  if (Array.isArray(args)) {
+    const result = spawnSync(PSMUX_BIN, args.map((arg) => String(arg)), {
+      encoding: "utf8",
+      timeout: 10000,
+      stdio: ["pipe", "pipe", "pipe"],
+      windowsHide: true,
+      ...opts,
+    });
+    if ((result.status ?? 1) !== 0) {
+      const error = new Error((result.stderr || result.stdout || "psmux command failed").trim());
+      error.status = result.status;
+      throw error;
+    }
+    return (result.stdout || "").trim();
+  }
+
+  const result = execSync(`${quoteArg(PSMUX_BIN)} ${args}`, {
+    encoding: "utf8",
+    timeout: 10000,
+    stdio: ["pipe", "pipe", "pipe"],
+    windowsHide: true,
+    ...opts,
+  });
+  return result != null ? result.trim() : "";
+}
+
+/** psmux 실행 가능 여부 확인 */
+export function hasPsmux() {
+  try {
+    execSync(`${quoteArg(PSMUX_BIN)} -V`, {
+      stdio: "ignore",
+      timeout: 3000,
+      windowsHide: true,
+    });
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+/**
+ * psmux 커맨드 실행 래퍼
+ * @param {string|string[]} args
+ * @param {object} opts
+ * @returns {string}
+ */
+export function psmuxExec(args, opts = {}) {
+  return psmux(args, opts);
+}
+
+/**
+ * psmux 세션 생성 + 레이아웃 분할
+ * @param {string} sessionName
+ * @param {object} opts
+ * @param {'2x2'|'1xN'|'Nx1'} opts.layout
+ * @param {number} opts.paneCount
+ * @returns {{ sessionName: string, panes: string[] }}
+ */
+export function createPsmuxSession(sessionName, opts = {}) {
+  const layout = opts.layout === "1xN" || opts.layout === "Nx1" ? opts.layout : "2x2";
+  const paneCount = Math.max(
+    1,
+    Number.isFinite(opts.paneCount) ? Math.trunc(opts.paneCount) : 4
+  );
+  const limitedPaneCount = layout === "2x2" ? Math.min(paneCount, 4) : paneCount;
+  const sessionTarget = `${sessionName}:0`;
+
+  const leadPane = psmuxExec(
+    `new-session -d -P -F "#{session_name}:#{window_index}.#{pane_index}" -s ${quoteArg(sessionName)} -x 220 -y 55`
+  );
+
+  if (layout === "2x2" && limitedPaneCount >= 3) {
+    const rightPane = psmuxExec(
+      `split-window -h -P -F "#{session_name}:#{window_index}.#{pane_index}" -t ${quoteArg(leadPane)}`
+    );
+    psmuxExec(
+      `split-window -v -P -F "#{session_name}:#{window_index}.#{pane_index}" -t ${quoteArg(rightPane)}`
+    );
+    if (limitedPaneCount >= 4) {
+      psmuxExec(
+        `split-window -v -P -F "#{session_name}:#{window_index}.#{pane_index}" -t ${quoteArg(leadPane)}`
+      );
+    }
+    psmuxExec(`select-layout -t ${quoteArg(sessionTarget)} tiled`);
+  } else if (layout === "1xN") {
+    for (let i = 1; i < limitedPaneCount; i++) {
+      psmuxExec(`split-window -h -t ${quoteArg(sessionTarget)}`);
+    }
+    psmuxExec(`select-layout -t ${quoteArg(sessionTarget)} even-horizontal`);
+  } else {
+    for (let i = 1; i < limitedPaneCount; i++) {
+      psmuxExec(`split-window -v -t ${quoteArg(sessionTarget)}`);
+    }
+    psmuxExec(`select-layout -t ${quoteArg(sessionTarget)} even-vertical`);
+  }
+
+  psmuxExec(`select-pane -t ${quoteArg(leadPane)}`);
+
+  const panes = collectSessionPanes(sessionName).slice(0, limitedPaneCount);
+  panes.forEach((pane, index) => {
+    psmuxExec(`select-pane -t ${quoteArg(pane)} -T ${quoteArg(toPaneTitle(index))}`);
+  });
+
+  return { sessionName, panes };
+}
+
+/**
+ * psmux 세션 종료
+ * @param {string} sessionName
+ */
+export function killPsmuxSession(sessionName) {
+  try {
+    psmuxExec(`kill-session -t ${quoteArg(sessionName)}`, { stdio: "ignore" });
+  } catch {
+    // 이미 종료된 세션 — 무시
+  }
+}
+
+/**
+ * psmux 세션 존재 확인
+ * @param {string} sessionName
+ * @returns {boolean}
+ */
+export function psmuxSessionExists(sessionName) {
+  try {
+    psmuxExec(`has-session -t ${quoteArg(sessionName)}`, { stdio: "ignore" });
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+/**
+ * tfx-multi- 접두사 psmux 세션 목록
+ * @returns {string[]}
+ */
+export function listPsmuxSessions() {
+  try {
+    return parseSessionSummaries(psmuxExec("list-sessions"))
+      .map((session) => session.sessionName)
+      .filter((sessionName) => sessionName.startsWith("tfx-multi-"));
+  } catch {
+    return [];
+  }
+}
+
+/**
+ * pane 마지막 N줄 캡처
+ * @param {string} target
+ * @param {number} lines
+ * @returns {string}
+ */
+export function capturePsmuxPane(target, lines = 5) {
+  try {
+    const full = psmuxExec(`capture-pane -t ${quoteArg(target)} -p`);
+    const nonEmpty = full.split("\n").filter((line) => line.trim() !== "");
+    return nonEmpty.slice(-lines).join("\n");
+  } catch {
+    return "";
+  }
+}
+
+/**
+ * psmux 세션 연결
+ * @param {string} sessionName
+ */
+export function attachPsmuxSession(sessionName) {
+  const result = spawnSync(PSMUX_BIN, ["attach-session", "-t", sessionName], {
+    stdio: "inherit",
+    timeout: 0,
+    windowsHide: false,
+  });
+  if ((result.status ?? 1) !== 0) {
+    throw new Error(`psmux attach 실패 (exit=${result.status})`);
+  }
+}
+
+/**
+ * 세션 attach client 수 조회
+ * @param {string} sessionName
+ * @returns {number|null}
+ */
+export function getPsmuxSessionAttachedCount(sessionName) {
+  try {
+    const session = parseSessionSummaries(psmuxExec("list-sessions"))
+      .find((entry) => entry.sessionName === sessionName);
+    return session ? session.attachedCount : null;
+  } catch {
+    return null;
+  }
+}
+
+/**
+ * 팀메이트 조작 키 바인딩 설정
+ * @param {string} sessionName
+ * @param {object} opts
+ * @param {boolean} opts.inProcess
+ * @param {string} opts.taskListCommand
+ */
+export function configurePsmuxKeybindings(sessionName, opts = {}) {
+  const { inProcess = false, taskListCommand = "" } = opts;
+  const cond = `#{==:#{session_name},${sessionName}}`;
+  const target = `${sessionName}:0`;
+  const bindNext = inProcess
+    ? `'select-pane -t :.+ \\; resize-pane -Z'`
+    : `'select-pane -t :.+'`;
+  const bindPrev = inProcess
+    ? `'select-pane -t :.- \\; resize-pane -Z'`
+    : `'select-pane -t :.-'`;
+
+  // psmux는 세션별 서버이므로 -t target으로 세션 컨텍스트를 전달해야 한다
+  const bindSafe = (cmd) => {
+    try { psmuxExec(`-t ${quoteArg(target)} ${cmd}`); } catch { /* 미지원 시 무시 */ }
+  };
+
+  bindSafe(`bind-key -T root -n S-Down if-shell -F '${cond}' ${bindNext} 'send-keys S-Down'`);
+  bindSafe(`bind-key -T root -n S-Up if-shell -F '${cond}' ${bindPrev} 'send-keys S-Up'`);
+  bindSafe(`bind-key -T root -n S-Right if-shell -F '${cond}' ${bindNext} 'send-keys S-Right'`);
+  bindSafe(`bind-key -T root -n S-Left if-shell -F '${cond}' ${bindPrev} 'send-keys S-Left'`);
+  bindSafe(`bind-key -T root -n BTab if-shell -F '${cond}' ${bindPrev} 'send-keys BTab'`);
+  bindSafe(`bind-key -T root -n Escape if-shell -F '${cond}' 'send-keys C-c' 'send-keys Escape'`);
+
+  if (taskListCommand) {
+    const escaped = taskListCommand.replace(/'/g, "'\\''");
+    bindSafe(
+      `bind-key -T root -n C-t if-shell -F '${cond}' "display-popup -E '${escaped}'" "send-keys C-t"`
+    );
+  }
+}