@triflux/remote 10.1.0 → 10.25.1

package/hub/team/orchestrator.mjs

@@ -1,161 +1,173 @@
-// hub/team/orchestrator.mjs — 작업 분배 + 프롬프트 구성
-// 의존성: pane.mjs만 사용
-import { injectPrompt } from "./pane.mjs";
-
-/**
- * 작업 분해 (LLM 없이 구분자 기반)
- * @param {string} taskDescription — 전체 작업 설명
- * @param {number} agentCount — 에이전트 수
- * @returns {string[]} 각 에이전트의 서브태스크
- */
-export function decomposeTask(taskDescription, agentCount) {
-  if (agentCount <= 0) return [];
-  if (agentCount === 1) return [taskDescription];
-
-  // '+', ',', '\n' 기준으로 분리
-  const parts = taskDescription
-    .split(/[+,\n]+/)
-    .map((s) => s.trim())
-    .filter(Boolean);
-
-  if (parts.length === 0) return [taskDescription];
-
-  // 에이전트보다 서브태스크가 적으면 마지막 에이전트에 전체 태스크 부여
-  if (parts.length < agentCount) {
-    const result = [...parts];
-    while (result.length < agentCount) {
-      result.push(taskDescription);
-    }
-    return result;
-  }
-
-  // 에이전트보다 서브태스크가 많으면 앞에서부터 N개, 나머지는 마지막에 합침
-  if (parts.length > agentCount) {
-    const result = parts.slice(0, agentCount - 1);
-    result.push(parts.slice(agentCount - 1).join(" + "));
-    return result;
-  }
-
-  return parts;
-}
-
-/**
- * 리드(보통 claude) 초기 프롬프트 생성
- * @param {string} taskDescription
- * @param {object} config
- * @param {string} config.agentId
- * @param {string} config.hubUrl
- * @param {string} config.teammateMode
- * @param {Array<{agentId:string, cli:string, subtask:string}>} config.workers
- * @returns {string}
- */
-export function buildLeadPrompt(taskDescription, config) {
-  const { agentId, teammateMode = "tmux", workers = [] } = config;
-
-  const roster = workers
-    .map((w, i) => `${i + 1}. ${w.agentId} (${w.cli}) — ${w.subtask}`)
-    .join("\n") || "- (워커 없음)";
-
-  const workerIds = workers.map((w) => w.agentId).join(", ");
-
-  const bridgePath = "node hub/bridge.mjs";
-
-  return `리드 에이전트: ${agentId}
-
-목표: ${taskDescription}
-모드: ${teammateMode}
-
-워커:
-${roster}
-
-규칙:
-- 가능한 짧고 핵심만 지시/요약(토큰 절약)
-- 워커 제어:
-  ${bridgePath} result --agent ${agentId} --topic lead.control
-- 워커 결과 수집:
-  ${bridgePath} context --agent ${agentId} --max 20
-- 최종 결과는 topic="task.result"를 모아 통합
-
-워커 ID: ${workerIds || "(없음)"}
-지금 즉시 워커를 배정하고 병렬 진행을 관리하라.`;
-}
-
-/**
- * 워커 초기 프롬프트 생성
- * @param {string} subtask — 이 에이전트의 서브태스크
- * @param {object} config
- * @param {string} config.cli — codex/gemini/claude
- * @param {string} config.agentId — 에이전트 식별자
- * @param {string} config.hubUrl — Hub URL
- * @returns {string}
- */
-export function buildPrompt(subtask, config) {
-  const { cli, agentId, hubUrl } = config;
-
-  const _hubBase = hubUrl.replace("/mcp", "");
-
-  const bridgePath = "node hub/bridge.mjs";
-
-  return `워커: ${agentId} (${cli})
-작업: ${subtask}
-
-필수 규칙:
-1) 간결하게 작업(불필요한 장문 설명 금지)
-2) 시작 즉시 등록:
-   ${bridgePath} register --agent ${agentId} --cli ${cli} --topics lead.control,task.result
-3) 주기적으로 수신함 확인:
-   ${bridgePath} context --agent ${agentId} --max 10
-4) lead.control 수신 시 즉시 반응 (interrupt/stop/pause/resume)
-5) 완료 시 결과 발행:
-   ${bridgePath} result --agent ${agentId} --topic task.result --file <출력파일>
-
-지금 작업을 시작하라.`;
-}
-
-/**
- * 팀 오케스트레이션 실행 — 각 pane에 프롬프트 주입
- * @param {string} sessionName — tmux 세션 이름
- * @param {Array<{target: string, cli: string, subtask: string}>} assignments
- * @param {object} opts
- * @param {string} opts.hubUrl — Hub URL
- * @param {{target:string, cli:string, task:string}|null} opts.lead
- * @param {string} opts.teammateMode
- * @returns {Promise<void>}
- */
-export async function orchestrate(sessionName, assignments, opts = {}) {
-  const {
-    hubUrl = "http://127.0.0.1:27888/mcp",
-    lead = null,
-    teammateMode = "tmux",
-  } = opts;
-
-  const workers = assignments.map(({ target, cli, subtask }) => ({
-    target,
-    cli,
-    subtask,
-    agentId: `${cli}-${target.split(".").pop()}`,
-  }));
-
-  if (lead?.target) {
-    const leadAgentId = `${lead.cli || "claude"}-${lead.target.split(".").pop()}`;
-    const leadPrompt = buildLeadPrompt(lead.task || "팀 작업 조율", {
-      agentId: leadAgentId,
-      hubUrl,
-      teammateMode,
-      workers: workers.map((w) => ({ agentId: w.agentId, cli: w.cli, subtask: w.subtask })),
-    });
-    injectPrompt(lead.target, leadPrompt, { useFileRef: true });
-    await new Promise((r) => setTimeout(r, 100));
-  }
-
-  for (const worker of workers) {
-    const prompt = buildPrompt(worker.subtask, {
-      cli: worker.cli,
-      agentId: worker.agentId,
-      hubUrl,
-      sessionName,
-    });
-    injectPrompt(worker.target, prompt, { useFileRef: true });
-    await new Promise((r) => setTimeout(r, 100));
-  }
-}
+// hub/team/orchestrator.mjs — 작업 분배 + 프롬프트 구성
+// 의존성: pane.mjs만 사용
+import { injectPrompt as defaultInjectPrompt } from "./pane.mjs";
+
+/**
+ * 작업 분해 (LLM 없이 구분자 기반)
+ * @param {string} taskDescription — 전체 작업 설명
+ * @param {number} agentCount — 에이전트 수
+ * @returns {string[]} 각 에이전트의 서브태스크
+ */
+export function decomposeTask(taskDescription, agentCount) {
+  if (agentCount <= 0) return [];
+  if (agentCount === 1) return [taskDescription];
+
+  // '+', ',', '\n' 기준으로 분리
+  const parts = taskDescription
+    .split(/[+,\n]+/)
+    .map((s) => s.trim())
+    .filter(Boolean);
+
+  if (parts.length === 0) return [taskDescription];
+
+  // 에이전트보다 서브태스크가 적으면 마지막 에이전트에 전체 태스크 부여
+  if (parts.length < agentCount) {
+    const result = [...parts];
+    while (result.length < agentCount) {
+      result.push(taskDescription);
+    }
+    return result;
+  }
+
+  // 에이전트보다 서브태스크가 많으면 앞에서부터 N개, 나머지는 마지막에 합침
+  if (parts.length > agentCount) {
+    const result = parts.slice(0, agentCount - 1);
+    result.push(parts.slice(agentCount - 1).join(" + "));
+    return result;
+  }
+
+  return parts;
+}
+
+/**
+ * 리드(보통 claude) 초기 프롬프트 생성
+ * @param {string} taskDescription
+ * @param {object} config
+ * @param {string} config.agentId
+ * @param {string} config.hubUrl
+ * @param {string} config.teammateMode
+ * @param {Array<{agentId:string, cli:string, subtask:string}>} config.workers
+ * @returns {string}
+ */
+export function buildLeadPrompt(taskDescription, config) {
+  const { agentId, teammateMode = "tmux", workers = [] } = config;
+
+  const roster =
+    workers
+      .map((w, i) => `${i + 1}. ${w.agentId} (${w.cli}) — ${w.subtask}`)
+      .join("\n") || "- (워커 없음)";
+
+  const workerIds = workers.map((w) => w.agentId).join(", ");
+
+  const bridgePath = "node hub/bridge.mjs";
+
+  return `리드 에이전트: ${agentId}
+
+목표: ${taskDescription}
+모드: ${teammateMode}
+
+워커:
+${roster}
+
+규칙:
+- 가능한 짧고 핵심만 지시/요약(토큰 절약)
+- 워커 제어:
+  ${bridgePath} result --agent ${agentId} --topic lead.control
+- 워커 결과 수집:
+  ${bridgePath} context --agent ${agentId} --max 20
+- 최종 결과는 topic="task.result"를 모아 통합
+
+워커 ID: ${workerIds || "(없음)"}
+지금 즉시 워커를 배정하고 병렬 진행을 관리하라.`;
+}
+
+/**
+ * 워커 초기 프롬프트 생성
+ * @param {string} subtask — 이 에이전트의 서브태스크
+ * @param {object} config
+ * @param {string} config.cli — codex/gemini/claude
+ * @param {string} config.agentId — 에이전트 식별자
+ * @param {string} config.hubUrl — Hub URL
+ * @returns {string}
+ */
+export function buildPrompt(subtask, config) {
+  const { cli, agentId, hubUrl } = config;
+
+  const _hubBase = hubUrl.replace("/mcp", "");
+
+  const bridgePath = "node hub/bridge.mjs";
+
+  return `워커: ${agentId} (${cli})
+작업: ${subtask}
+
+필수 규칙:
+1) 간결하게 작업(불필요한 장문 설명 금지)
+2) 시작 즉시 등록:
+   ${bridgePath} register --agent ${agentId} --cli ${cli} --topics lead.control,task.result
+3) 주기적으로 수신함 확인:
+   ${bridgePath} context --agent ${agentId} --max 10
+4) lead.control 수신 시 즉시 반응 (interrupt/stop/pause/resume)
+5) 완료 시 결과 발행:
+   ${bridgePath} result --agent ${agentId} --topic task.result --file <출력파일>
+
+지금 작업을 시작하라.`;
+}
+
+/**
+ * 팀 오케스트레이션 실행 — 각 pane에 프롬프트 주입
+ * @param {string} sessionName — tmux 세션 이름
+ * @param {Array<{target: string, cli: string, subtask: string}>} assignments
+ * @param {object} opts
+ * @param {string} opts.hubUrl — Hub URL
+ * @param {{target:string, cli:string, task:string}|null} opts.lead
+ * @param {string} opts.teammateMode
+ * @returns {Promise<void>}
+ */
+export async function orchestrate(sessionName, assignments, opts = {}) {
+  const {
+    hubUrl = "http://127.0.0.1:27888/mcp",
+    lead = null,
+    teammateMode = "tmux",
+    injectPrompt = defaultInjectPrompt,
+  } = opts;
+
+  const workers = assignments.map(({ target, cli, subtask }) => ({
+    target,
+    cli,
+    subtask,
+    agentId: `${cli}-${target.split(".").pop()}`,
+  }));
+
+  if (lead?.target) {
+    const leadAgentId = `${lead.cli || "claude"}-${lead.target.split(".").pop()}`;
+    const leadPrompt = buildLeadPrompt(lead.task || "팀 작업 조율", {
+      agentId: leadAgentId,
+      hubUrl,
+      teammateMode,
+      workers: workers.map((w) => ({
+        agentId: w.agentId,
+        cli: w.cli,
+        subtask: w.subtask,
+      })),
+    });
+    injectPrompt(lead.target, leadPrompt, {
+      useFileRef: true,
+      cli: lead.cli,
+    });
+    await new Promise((r) => setTimeout(r, 100));
+  }
+
+  for (const worker of workers) {
+    const prompt = buildPrompt(worker.subtask, {
+      cli: worker.cli,
+      agentId: worker.agentId,
+      hubUrl,
+      sessionName,
+    });
+    injectPrompt(worker.target, prompt, {
+      useFileRef: true,
+      cli: worker.cli,
+    });
+    await new Promise((r) => setTimeout(r, 100));
+  }
+}

package/hub/team/pane.mjs

@@ -1,12 +1,11 @@
 // 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 { mkdirSync, unlinkSync, writeFileSync } from "node:fs";
 import { tmpdir } from "node:os";
-import { detectMultiplexer, tmuxExec } from "./session.mjs";
-import { psmuxExec } from "./psmux.mjs";
-
+import { join } from "node:path";
 import { buildExecArgs } from "@triflux/core/hub/codex-adapter.mjs";
+import { psmuxExec } from "./psmux.mjs";
+import { detectMultiplexer, tmuxExec } from "./session.mjs";
 
 function quoteArg(value) {
   return `"${String(value).replace(/"/g, '\\"')}"`;
@@ -91,34 +90,61 @@ export function startCliInPane(target, command) {
 }
 
 /**
- * pane에 프롬프트 주입 (load-buffer + paste-buffer 방식)
- * 멀티라인 + 특수문자 안전, 크기 제한 없음
- * @param {string} target — 예: tfx-multi-abc:0.1
- * @param {string} prompt — 주입할 텍스트
+ * psmux `@file` 참조 주입이 가능한 CLI인지 판정한다.
+ *
+ * Codex TUI는 `@` 입력이 있으면 sync_file_search_popup 경로로 FileSearchPopup을
+ * 활성화한다 (call-site `codex-rs/tui/src/bottom_pane/chat_composer.rs:3082`;
+ * 본체 L3271-3313 에서 `ActivePopup::File(popup)` 분기; 빈 query 상태는
+ * `file_search_popup.rs:54-63` 의 `set_empty_prompt()` 가 정의). 팝업이 떠 있는
+ * 동안의 Enter 처리는 같은 파일 composer의 Enter handler (`chat_composer.rs:1585-1645`
+ * 기준) 에서 popup 선택 path insert 또는 dismiss 로 분기하므로 prompt submit 으로
+ * 전달되지 않는다. Gemini CLI의 `@path`는 공식 client-side file-content inject
+ * 이므로 유지. Codex TUI에서 `@path` 선택은 path 문자열만 textarea에 insert할
+ * 뿐 Gemini처럼 파일 내용을 inject하지 않으며, 별도 file-injection slash
+ * command 도 존재하지 않음 (slash_commands / prompt_args / skill_popup /
+ * command_popup 소스 전수 grep 결과 0건, 2026-04-19 검증 — absence-based).
+ *
+ * @param {{ multiplexer: string, useFileRef: boolean, cli: string|null }} args
  */
+export function shouldUseFileRef({ multiplexer, useFileRef, cli }) {
+  return multiplexer === "psmux" && useFileRef && cli !== "codex";
+}
+
 /**
  * pane에 프롬프트 주입
  * @param {string} target — 예: tfx-multi-abc:0.1
  * @param {string} prompt — 주입할 텍스트
  * @param {object} [opts]
- * @param {boolean} [opts.useFileRef] — true면 TUI용 @file 참조 방식 (psmux 전용)
+ * @param {boolean} [opts.useFileRef] — true면 TUI용 @file 참조 방식 요청 (psmux 전용). Codex에서는 자동으로 paste-buffer 경로로 fallback.
+ * @param {'codex'|'gemini'|'claude'|null} [opts.cli] — 대상 CLI. Codex일 때 @ intercept를 회피하기 위해 paste-buffer 경로를 강제한다.
  */
-export function injectPrompt(target, prompt, { useFileRef = false } = {}) {
+export function injectPrompt(
+  target,
+  prompt,
+  { useFileRef = false, cli = null } = {},
+) {
   const tmpDir = join(tmpdir(), "tfx-multi");
   mkdirSync(tmpDir, { recursive: true });
 
   const safeTarget = target.replace(/[:.]/g, "-");
   const tmpFile = join(tmpDir, `prompt-${safeTarget}-${Date.now()}.txt`);
 
-  // psmux + TUI 앱: @file 참조로 주입 (paste-buffer는 TUI와 호환 안 됨)
-  if (detectMultiplexer() === "psmux" && useFileRef) {
+  const multiplexer = detectMultiplexer();
+
+  // psmux + TUI + CLI별 @file 지원: @path를 literal paste하고 Enter로 확정.
+  // Codex는 @가 file search popup을 intercept하므로 paste-buffer 경로로 fallback.
+  if (shouldUseFileRef({ multiplexer, useFileRef, cli })) {
     writeFileSync(tmpFile, prompt, "utf8");
     const filePath = tmpFile.replace(/\\/g, "/");
     psmuxExec(["select-pane", "-t", target]);
     psmuxExec(["send-keys", "-t", target, "-l", `@${filePath}`]);
     psmuxExec(["send-keys", "-t", target, "Enter"]);
     // TUI가 파일을 읽을 시간을 주고 정리
-    setTimeout(() => { try { unlinkSync(tmpFile); } catch {} }, 10000);
+    setTimeout(() => {
+      try {
+        unlinkSync(tmpFile);
+      } catch {}
+    }, 10000);
     return;
   }
 
@@ -139,7 +165,9 @@ export function injectPrompt(target, prompt, { useFileRef = false } = {}) {
     muxExec(`paste-buffer -t ${target}`);
     muxExec(`send-keys -t ${target} Enter`);
   } finally {
-    try { unlinkSync(tmpFile); } catch {}
+    try {
+      unlinkSync(tmpFile);
+    } catch {}
   }
 }
 

package/hub/team/process-cleanup.mjs

@@ -1,7 +1,7 @@
 // hub/team/process-cleanup.mjs — 고아 node/python 프로세스 감지 및 정리
 // Windows: Get-CimInstance Win32_Process로 parent PID + cmdLine 접근
 // Unix: ps aux 파싱
-import { execFile as nodeExecFile } from "node:child_process";
+import { execFileSync, execFile as nodeExecFile } from "node:child_process";
 import { promisify } from "node:util";
 import { IS_WINDOWS } from "@triflux/core/hub/platform.mjs";
 
@@ -12,11 +12,37 @@ const execFileAsync = promisify(nodeExecFile);
 const TARGET_PROCESS_NAMES = ["node", "python", "python3"];
 const SIGTERM_GRACE_MS = 5000;
 
+export function forceKillPid(
+  pid,
+  {
+    isWindows = IS_WINDOWS,
+    execFileSyncFn = execFileSync,
+    killFn = process.kill,
+  } = {},
+) {
+  if (isWindows) {
+    try {
+      execFileSyncFn("taskkill", ["/F", "/T", "/PID", String(pid)], {
+        stdio: "ignore",
+        timeout: 5000,
+        windowsHide: true,
+      });
+      return;
+    } catch (taskkillError) {
+      try {
+        killFn(pid);
+        return;
+      } catch {
+        throw taskkillError;
+      }
+    }
+  }
+
+  killFn(pid, "SIGKILL");
+}
+
 // cmdLine 패턴 기반 화이트리스트 (고아 후보에서 제외)
-const WHITELIST_CMDLINE = [
-  /oh-my-claudecode/i,
-  /triflux[\\/]hub[\\/]s/i,
-];
+const WHITELIST_CMDLINE = [/oh-my-claudecode/i, /triflux[\\/]hub[\\/]s/i];
 
 // 프로세스명 기반 화이트리스트
 const WHITELIST_NAMES = ["claude", "CCXProcess"];
@@ -44,15 +70,13 @@ async function queryWindowsProcesses(execFileFn) {
   const raw = JSON.parse(stdout.trim());
   const items = Array.isArray(raw) ? raw : [raw];
 
-  return items
-    .filter(Boolean)
-    .map((p) => ({
-      pid: Number(p.ProcessId),
-      name: String(p.Name || "").replace(/\.exe$/i, ""),
-      parentPid: Number(p.ParentProcessId) || 0,
-      cmdLine: String(p.CommandLine || ""),
-      ramMB: Math.round((Number(p.WorkingSetSize) || 0) / 1024 / 1024),
-    }));
+  return items.filter(Boolean).map((p) => ({
+    pid: Number(p.ProcessId),
+    name: String(p.Name || "").replace(/\.exe$/i, ""),
+    parentPid: Number(p.ParentProcessId) || 0,
+    cmdLine: String(p.CommandLine || ""),
+    ramMB: Math.round((Number(p.WorkingSetSize) || 0) / 1024 / 1024),
+  }));
 }
 
 /**
@@ -63,7 +87,7 @@ async function queryWindowsProcesses(execFileFn) {
 async function queryUnixProcesses(execFileFn) {
   const { stdout } = await execFileFn(
     "ps",
-    ["-eo", "pid,ppid,rss,comm,args", "--no-headers"],
+    ["-eo", "pid=,ppid=,rss=,comm=,args="],
     { encoding: "utf8", timeout: 10_000 },
   );
 
@@ -225,7 +249,11 @@ export async function findOrphanProcesses(opts = {}) {
     const nameLower = p.name.toLowerCase();
 
     // 대상 프로세스만
-    if (!TARGET_PROCESS_NAMES.some((t) => nameLower === t || nameLower === `${t}.exe`)) {
+    if (
+      !TARGET_PROCESS_NAMES.some(
+        (t) => nameLower === t || nameLower === `${t}.exe`,
+      )
+    ) {
       return false;
     }
 
@@ -275,6 +303,12 @@ export async function findOrphanProcesses(opts = {}) {
 export function createProcessCleanup(opts = {}) {
   const execFileFn = opts.execFileFn ?? execFileAsync;
   const dryRun = opts.dryRun ?? false;
+  const isWindows = opts.isWindows ?? IS_WINDOWS;
+  const execFileSyncFn = opts.execFileSyncFn ?? execFileSync;
+  const killFn = opts.killFn ?? process.kill;
+  const sleepFn =
+    opts.sleepFn ?? ((ms) => new Promise((resolve) => setTimeout(resolve, ms)));
+  const sigtermGraceMs = opts.sigtermGraceMs ?? SIGTERM_GRACE_MS;
 
   let lastOrphans = [];
 
@@ -294,35 +328,45 @@ export function createProcessCleanup(opts = {}) {
   /**
    * 마지막 scan 결과의 프로세스를 kill한다.
    * dryRun=true이면 kill 없이 목록만 반환한다.
-   * SIGTERM → 5s 대기 → SIGKILL 순서.
+   * SIGTERM → 5s 대기 → 강제 종료(taskkill/SIGKILL) 순서.
    * @returns {Promise<Array<{pid,name,killed,error}>>}
    */
   async function kill() {
     if (dryRun) {
-      return lastOrphans.map((p) => ({ pid: p.pid, name: p.name, killed: false, dryRun: true }));
+      return lastOrphans.map((p) => ({
+        pid: p.pid,
+        name: p.name,
+        killed: false,
+        dryRun: true,
+      }));
     }
 
     const results = await Promise.all(
       lastOrphans.map(async (p) => {
         try {
           // SIGTERM
-          process.kill(p.pid, "SIGTERM");
+          killFn(p.pid, "SIGTERM");
 
-          // 5초 대기 후 살아있으면 SIGKILL
-          await new Promise((resolve) => setTimeout(resolve, SIGTERM_GRACE_MS));
+          // 5초 대기 후 살아있으면 강제 종료
+          await sleepFn(sigtermGraceMs);
 
           try {
             // 프로세스가 아직 살아있는지 확인 (signal 0)
-            process.kill(p.pid, 0);
-            // 여전히 살아있음 → SIGKILL
-            process.kill(p.pid, "SIGKILL");
+            killFn(p.pid, 0);
+            // 여전히 살아있음 → Windows는 taskkill/process.kill, 그 외는 SIGKILL
+            forceKillPid(p.pid, { isWindows, execFileSyncFn, killFn });
           } catch {
             // ESRCH: 이미 종료됨 — 정상
           }
 
           return { pid: p.pid, name: p.name, killed: true };
         } catch (err) {
-          return { pid: p.pid, name: p.name, killed: false, error: String(err.message || err) };
+          return {
+            pid: p.pid,
+            name: p.name,
+            killed: false,
+            error: String(err.message || err),
+          };
         }
       }),
     );