triflux 7.3.1 → 7.4.0

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "triflux",
-  "version": "7.2.1",
+  "version": "7.4.0",
   "description": "CLI-first multi-model orchestrator for Claude Code — route tasks to Codex, Gemini, and Claude",
   "author": {
     "name": "tellang"

package/hub/team/agent-map.json

@@ -5,6 +5,7 @@
   "scientist": "codex", "scientist-deep": "codex", "document-specialist": "codex",
   "spark": "codex",
   "designer": "gemini", "writer": "gemini",
-  "explore": "claude", "verifier": "claude", "test-engineer": "claude", "qa-tester": "claude",
+  "explore": "claude",
+  "verifier": "codex", "test-engineer": "codex", "qa-tester": "codex",
   "codex": "codex", "gemini": "gemini", "claude": "claude"
 }

package/hub/team/backend.mjs

@@ -18,7 +18,8 @@ export class CodexBackend {
    * @returns {string} PowerShell 명령 (cls 제외)
    */
   buildArgs(prompt, resultFile, opts = {}) {
-    return `codex exec ${prompt} -o '${resultFile}' --color never`;
+    const modelFlag = opts.model ? ` --model '${opts.model}'` : "";
+    return `codex exec --dangerously-bypass-approvals-and-sandbox ${prompt} --output-last-message '${resultFile}' --color never${modelFlag}`;
   }
 
   env() { return {}; }
@@ -29,7 +30,7 @@ export class GeminiBackend {
   command() { return "gemini"; }
 
   buildArgs(prompt, resultFile, opts = {}) {
-    return `gemini -p ${prompt} -o text > '${resultFile}' 2>'${resultFile}.err'`;
+    return `gemini --prompt ${prompt} -o text > '${resultFile}' 2>'${resultFile}.err'`;
   }
 
   env() { return {}; }
@@ -40,7 +41,7 @@ export class ClaudeBackend {
   command() { return "claude"; }
 
   buildArgs(prompt, resultFile, opts = {}) {
-    return `claude -p ${prompt} --output-format text > '${resultFile}' 2>&1`;
+    return `claude --print ${prompt} --output-format text > '${resultFile}' 2>&1`;
   }
 
   env() { return {}; }

package/hub/team/cli/commands/start/index.mjs

@@ -38,7 +38,7 @@ function renderTmuxInstallHelp() {
 export { parseTeamArgs };
 
 export async function teamStart(args = []) {
-  const { agents, lead, layout, teammateMode, task: rawTask, assigns, autoAttach, progressive, timeoutSec, verbose, dashboard, mcpProfile } = parseTeamArgs(args);
+  const { agents, lead, layout, teammateMode, task: rawTask, assigns, autoAttach, progressive, timeoutSec, verbose, dashboard, mcpProfile, model } = parseTeamArgs(args);
   // --assign 사용 시 task를 자동 생성
   const task = rawTask || (assigns.length > 0 ? assigns.map(a => a.prompt).join(" + ") : "");
   if (!task) return printStartUsage();
@@ -82,7 +82,7 @@ export async function teamStart(args = []) {
   const state = effectiveMode === "in-process"
     ? await startInProcessTeam({ sessionId, task, lead, agents, subtasks, hubUrl })
     : effectiveMode === "headless"
-      ? await startHeadlessTeam({ sessionId, task, lead, agents, subtasks, layout, assigns, autoAttach, progressive, timeoutSec, verbose, dashboard, mcpProfile })
+      ? await startHeadlessTeam({ sessionId, task, lead, agents, subtasks, layout, assigns, autoAttach, progressive, timeoutSec, verbose, dashboard, mcpProfile, model })
       : effectiveMode === "wt"
         ? await startWtTeam({ sessionId, task, lead, agents, subtasks, layout, hubUrl })
         : await startMuxTeam({ sessionId, task, lead, agents, subtasks, layout, hubUrl, teammateMode: effectiveMode });

package/hub/team/cli/commands/start/parse-args.mjs

@@ -1,5 +1,40 @@
 import { normalizeLayout, normalizeTeammateMode } from "../../services/runtime-mode.mjs";
 
+// --assign 파싱 시 마지막 콜론 뒤를 role로 인식할 알려진 역할/CLI 이름
+const KNOWN_ROLES = new Set([
+  "codex", "gemini", "claude",
+  "executor", "architect", "planner", "analyst", "critic",
+  "debugger", "verifier", "code-reviewer", "security-reviewer",
+  "test-engineer", "designer", "writer", "scientist",
+]);
+
+/**
+ * --assign "cli:prompt:role" 형식을 콜론-안전하게 파싱한다.
+ * 프롬프트 내부의 콜론(:)은 구분자로 취급하지 않는다.
+ *
+ * 규칙:
+ *   1. 첫 번째 콜론 앞 = CLI 이름
+ *   2. 마지막 콜론 뒤가 KNOWN_ROLES에 있으면 role, 나머지가 prompt
+ *   3. 그 외에는 첫 콜론 뒤 전체가 prompt, role은 빈 문자열
+ */
+function parseAssignValue(raw) {
+  const firstColon = raw.indexOf(":");
+  if (firstColon < 0) return null;
+
+  const cli = raw.slice(0, firstColon).trim();
+  const rest = raw.slice(firstColon + 1);
+
+  const lastColon = rest.lastIndexOf(":");
+  if (lastColon > 0) {
+    const candidate = rest.slice(lastColon + 1).trim().toLowerCase();
+    if (KNOWN_ROLES.has(candidate)) {
+      return { cli, prompt: rest.slice(0, lastColon).trim(), role: candidate };
+    }
+  }
+
+  return { cli, prompt: rest.trim(), role: "" };
+}
+
 export function parseTeamArgs(args = []) {
   let agents = ["codex", "gemini"];
   let lead = "claude";
@@ -13,6 +48,7 @@ export function parseTeamArgs(args = []) {
   let verbose = false;
   let dashboard = false;
   let mcpProfile = "";
+  let model = "";
 
   for (let index = 0; index < args.length; index += 1) {
     const current = args[index];
@@ -25,11 +61,8 @@ export function parseTeamArgs(args = []) {
     } else if ((current === "--teammate-mode" || current === "--mode") && args[index + 1]) {
       teammateMode = args[++index];
     } else if (current === "--assign" && args[index + 1]) {
-      // "cli:prompt:role" 형식 파싱
-      const parts = args[++index].split(":");
-      if (parts.length >= 2) {
-        assigns.push({ cli: parts[0].trim(), prompt: parts.slice(1, -1).join(":").trim() || parts[1].trim(), role: parts[parts.length - 1]?.trim() || "" });
-      }
+      const parsed = parseAssignValue(args[++index]);
+      if (parsed) assigns.push(parsed);
     } else if (current === "--auto-attach") {
       autoAttach = true;
     } else if (current === "--no-auto-attach") {
@@ -44,6 +77,8 @@ export function parseTeamArgs(args = []) {
       timeoutSec = Number(args[++index]) || 300;
     } else if (current === "--mcp-profile" && args[index + 1]) {
       mcpProfile = args[++index].trim();
+    } else if ((current === "--model" || current === "-m") && args[index + 1]) {
+      model = args[++index].trim();
     } else if (current.startsWith("-")) {
       console.warn(`  ⚠ 미인식 플래그 무시: ${current}`);
     } else {
@@ -64,5 +99,6 @@ export function parseTeamArgs(args = []) {
     verbose,
     dashboard,
     mcpProfile,
+    model,
   };
 }

package/hub/team/cli/commands/start/start-headless.mjs

@@ -4,11 +4,11 @@ import { ok, warn } from "../../render.mjs";
 import { buildTasks } from "../../services/task-model.mjs";
 import { clearTeamState } from "../../services/state-store.mjs";
 
-export async function startHeadlessTeam({ sessionId, task, lead, agents, subtasks, layout, assigns, autoAttach, progressive, timeoutSec, verbose, dashboard, mcpProfile }) {
+export async function startHeadlessTeam({ sessionId, task, lead, agents, subtasks, layout, assigns, autoAttach, progressive, timeoutSec, verbose, dashboard, mcpProfile, model }) {
   // --assign이 있으면 그것을 사용, 없으면 agents+subtasks 조합
   const assignments = assigns && assigns.length > 0
-    ? assigns.map((a, i) => ({ cli: resolveCliType(a.cli), prompt: a.prompt, role: a.role || `worker-${i + 1}`, mcp: mcpProfile }))
-    : subtasks.map((subtask, i) => ({ cli: resolveCliType(agents[i] || agents[0]), prompt: subtask, role: `worker-${i + 1}`, mcp: mcpProfile }));
+    ? assigns.map((a, i) => ({ cli: resolveCliType(a.cli), prompt: a.prompt, role: a.role || `worker-${i + 1}`, mcp: mcpProfile, model }))
+    : subtasks.map((subtask, i) => ({ cli: resolveCliType(agents[i] || agents[0]), prompt: subtask, role: `worker-${i + 1}`, mcp: mcpProfile, model }));
 
   const startedAt = Date.now();
   ok(`headless ${assignments.length}워커 시작`);

package/hub/team/cli/services/native-control.mjs

@@ -1,115 +1,118 @@
-import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
-import { join } from "node:path";
-import { spawn } from "node:child_process";
-
-import { buildLeadPrompt, buildPrompt } from "../../orchestrator.mjs";
-import { HUB_PID_DIR, PKG_ROOT } from "./state-store.mjs";
-
-export function buildNativeCliCommand(cli) {
-  switch (cli) {
-    case "codex":
-      return "codex --dangerously-bypass-approvals-and-sandbox --no-alt-screen";
-    case "gemini":
-      return "gemini";
-    case "claude":
-      return "claude";
-    default:
-      return cli;
-  }
-}
-
-export async function startNativeSupervisor({ sessionId, task, lead, agents, subtasks, hubUrl }) {
-  const configPath = join(HUB_PID_DIR, `team-native-${sessionId}.config.json`);
-  const runtimePath = join(HUB_PID_DIR, `team-native-${sessionId}.runtime.json`);
-  const logsDir = join(HUB_PID_DIR, "team-logs", sessionId);
-  mkdirSync(logsDir, { recursive: true });
-
-  const leadMember = {
-    role: "lead",
-    name: "lead",
-    cli: lead,
-    agentId: `${lead}-lead`,
-    command: buildNativeCliCommand(lead),
-  };
-  const workers = agents.map((cli, index) => ({
-    role: "worker",
-    name: `${cli}-${index + 1}`,
-    cli,
-    agentId: `${cli}-w${index + 1}`,
-    command: buildNativeCliCommand(cli),
-    subtask: subtasks[index],
-  }));
-  const members = [
-    {
-      ...leadMember,
-      prompt: buildLeadPrompt(task, {
-        agentId: leadMember.agentId,
-        hubUrl,
-        teammateMode: "in-process",
-        workers: workers.map((worker) => ({
-          agentId: worker.agentId,
-          cli: worker.cli,
-          subtask: worker.subtask,
-        })),
-      }),
-    },
-    ...workers.map((worker) => ({
-      ...worker,
-      prompt: buildPrompt(worker.subtask, { cli: worker.cli, agentId: worker.agentId, hubUrl }),
-    })),
-  ];
-
-  writeFileSync(configPath, JSON.stringify({
-    sessionName: sessionId,
-    hubUrl,
-    startupDelayMs: 3000,
-    logsDir,
-    runtimeFile: runtimePath,
-    members,
-  }, null, 2) + "\n");
-
-  const child = spawn(process.execPath, [join(PKG_ROOT, "hub", "team", "native-supervisor.mjs"), "--config", configPath], {
-    detached: true,
-    stdio: "ignore",
-    env: { ...process.env },
-    windowsHide: true,
-  });
-  child.unref();
-
-  const deadline = Date.now() + 5000;
-  while (Date.now() < deadline) {
-    if (existsSync(runtimePath)) {
-      try {
-        const runtime = JSON.parse(readFileSync(runtimePath, "utf8"));
-        return { runtime, members };
-      } catch {}
-    }
-    await new Promise((resolve) => setTimeout(resolve, 100));
-  }
-
-  return { runtime: null, members };
-}
-
-export async function nativeRequest(state, path, body = {}) {
-  if (!state?.native?.controlUrl) return null;
-  try {
-    const res = await fetch(`${state.native.controlUrl}${path}`, {
-      method: "POST",
-      headers: { "Content-Type": "application/json" },
-      body: JSON.stringify(body),
-    });
-    return await res.json();
-  } catch {
-    return null;
-  }
-}
-
-export async function nativeGetStatus(state) {
-  if (!state?.native?.controlUrl) return null;
-  try {
-    const res = await fetch(`${state.native.controlUrl}/status`);
-    return await res.json();
-  } catch {
-    return null;
-  }
-}
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+import { spawn } from "node:child_process";
+
+import { buildLeadPrompt, buildPrompt } from "../../orchestrator.mjs";
+import { HUB_PID_DIR, PKG_ROOT } from "./state-store.mjs";
+import { FEATURES } from "../../codex-compat.mjs";
+
+export function buildNativeCliCommand(cli) {
+  switch (cli) {
+    case "codex":
+      return FEATURES.execSubcommand
+        ? "codex exec --dangerously-bypass-approvals-and-sandbox --skip-git-repo-check"
+        : "codex --dangerously-bypass-approvals-and-sandbox";
+    case "gemini":
+      return "gemini";
+    case "claude":
+      return "claude";
+    default:
+      return cli;
+  }
+}
+
+export async function startNativeSupervisor({ sessionId, task, lead, agents, subtasks, hubUrl }) {
+  const configPath = join(HUB_PID_DIR, `team-native-${sessionId}.config.json`);
+  const runtimePath = join(HUB_PID_DIR, `team-native-${sessionId}.runtime.json`);
+  const logsDir = join(HUB_PID_DIR, "team-logs", sessionId);
+  mkdirSync(logsDir, { recursive: true });
+
+  const leadMember = {
+    role: "lead",
+    name: "lead",
+    cli: lead,
+    agentId: `${lead}-lead`,
+    command: buildNativeCliCommand(lead),
+  };
+  const workers = agents.map((cli, index) => ({
+    role: "worker",
+    name: `${cli}-${index + 1}`,
+    cli,
+    agentId: `${cli}-w${index + 1}`,
+    command: buildNativeCliCommand(cli),
+    subtask: subtasks[index],
+  }));
+  const members = [
+    {
+      ...leadMember,
+      prompt: buildLeadPrompt(task, {
+        agentId: leadMember.agentId,
+        hubUrl,
+        teammateMode: "in-process",
+        workers: workers.map((worker) => ({
+          agentId: worker.agentId,
+          cli: worker.cli,
+          subtask: worker.subtask,
+        })),
+      }),
+    },
+    ...workers.map((worker) => ({
+      ...worker,
+      prompt: buildPrompt(worker.subtask, { cli: worker.cli, agentId: worker.agentId, hubUrl }),
+    })),
+  ];
+
+  writeFileSync(configPath, JSON.stringify({
+    sessionName: sessionId,
+    hubUrl,
+    startupDelayMs: 3000,
+    logsDir,
+    runtimeFile: runtimePath,
+    members,
+  }, null, 2) + "\n");
+
+  const child = spawn(process.execPath, [join(PKG_ROOT, "hub", "team", "native-supervisor.mjs"), "--config", configPath], {
+    detached: true,
+    stdio: "ignore",
+    env: { ...process.env },
+    windowsHide: true,
+  });
+  child.unref();
+
+  const deadline = Date.now() + 5000;
+  while (Date.now() < deadline) {
+    if (existsSync(runtimePath)) {
+      try {
+        const runtime = JSON.parse(readFileSync(runtimePath, "utf8"));
+        return { runtime, members };
+      } catch {}
+    }
+    await new Promise((resolve) => setTimeout(resolve, 100));
+  }
+
+  return { runtime: null, members };
+}
+
+export async function nativeRequest(state, path, body = {}) {
+  if (!state?.native?.controlUrl) return null;
+  try {
+    const res = await fetch(`${state.native.controlUrl}${path}`, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify(body),
+    });
+    return await res.json();
+  } catch {
+    return null;
+  }
+}
+
+export async function nativeGetStatus(state) {
+  if (!state?.native?.controlUrl) return null;
+  try {
+    const res = await fetch(`${state.native.controlUrl}/status`);
+    return await res.json();
+  } catch {
+    return null;
+  }
+}

package/hub/team/codex-compat.mjs

@@ -0,0 +1,78 @@
+// hub/team/codex-compat.mjs — Codex CLI 버전 어댑터
+// Codex 0.117.0+ (Rust 리라이트): exec 서브커맨드 기반
+import { execSync } from "node:child_process";
+
+let _cachedVersion = null;
+
+/**
+ * `codex --version` 실행 결과를 파싱하여 마이너 버전 숫자 반환.
+ * 파싱 실패 시 0 반환 (구버전으로 간주).
+ * @returns {number} 마이너 버전 (예: 0.117.0 → 117)
+ */
+export function getCodexVersion() {
+  if (_cachedVersion !== null) return _cachedVersion;
+  try {
+    const out = execSync("codex --version", { encoding: "utf8", timeout: 5000 }).trim();
+    // "codex 0.117.0" 또는 "0.117.0" 형식 대응
+    const m = out.match(/(\d+)\.(\d+)\.(\d+)/);
+    _cachedVersion = m ? parseInt(m[2], 10) : 0;
+  } catch {
+    _cachedVersion = 0;
+  }
+  return _cachedVersion;
+}
+
+/**
+ * 최소 마이너 버전 이상인지 확인.
+ * @param {number} minMinor
+ * @returns {boolean}
+ */
+export function gte(minMinor) {
+  return getCodexVersion() >= minMinor;
+}
+
+/**
+ * Codex CLI 기능별 분기 객체.
+ * 117 = 0.117.0 (Rust 리라이트, exec 서브커맨드 도입)
+ */
+export const FEATURES = {
+  /** exec 서브커맨드 사용 가능 여부 */
+  get execSubcommand() { return gte(117); },
+  /** --output-last-message 플래그 지원 여부 */
+  get outputLastMessage() { return gte(117); },
+  /** --color never 플래그 지원 여부 */
+  get colorNever() { return gte(117); },
+  /** 플러그인 시스템 지원 여부 (향후 확장용) */
+  get pluginSystem() { return gte(120); },
+};
+
+/**
+ * long-form 플래그 기반 명령 빌더.
+ * @param {string} prompt
+ * @param {string|null} resultFile — null이면 --output-last-message 생략
+ * @param {{ profile?: string, skipGitRepoCheck?: boolean, sandboxBypass?: boolean }} [opts]
+ * @returns {string} 실행할 셸 커맨드
+ */
+export function buildExecCommand(prompt, resultFile = null, opts = {}) {
+  const { profile, skipGitRepoCheck = true, sandboxBypass = true } = opts;
+
+  const parts = ["codex"];
+  if (profile) parts.push("--profile", profile);
+
+  if (FEATURES.execSubcommand) {
+    parts.push("exec");
+    if (sandboxBypass) parts.push("--dangerously-bypass-approvals-and-sandbox");
+    if (skipGitRepoCheck) parts.push("--skip-git-repo-check");
+    if (resultFile && FEATURES.outputLastMessage) {
+      parts.push("--output-last-message", resultFile);
+    }
+    if (FEATURES.colorNever) parts.push("--color", "never");
+  } else {
+    // 구버전 fallback
+    parts.push("--dangerously-bypass-approvals-and-sandbox");
+    if (skipGitRepoCheck) parts.push("--skip-git-repo-check");
+  }
+
+  parts.push(JSON.stringify(prompt));
+  return parts.join(" ");
+}

package/hub/team/headless.mjs

@@ -67,7 +67,7 @@ const MCP_PROFILE_HINTS = {
  * @returns {string} PowerShell 명령
  */
 export function buildHeadlessCommand(cli, prompt, resultFile, opts = {}) {
-  const { handoff = true, mcp, contextFile } = opts;
+  const { handoff = true, mcp, contextFile, model } = opts;
   const resolvedCli = resolveCliType(cli);
 
   // contextFile 처리: 32KB(32768 bytes) 초과 시 UTF-8 안전 절단
@@ -96,7 +96,7 @@ export function buildHeadlessCommand(cli, prompt, resultFile, opts = {}) {
 
   const backend = getBackend(resolvedCli);
   const promptExpr = `(Get-Content -Raw '${promptFile}')`;
-  return `${cls}${backend.buildArgs(promptExpr, resultFile, opts)}`;
+  return `${cls}${backend.buildArgs(promptExpr, resultFile, { ...opts, model })}`;
 }
 
 /**
@@ -151,7 +151,7 @@ async function dispatchProgressive(sessionName, assignments, layout, safeProgres
 
     // 캡처 시작 + 컬러 배너 + 명령 dispatch
     const resultFile = join(RESULT_DIR, `${sessionName}-${paneName}.txt`).replace(/\\/g, "/");
-    const cmd = buildHeadlessCommand(assignment.cli, assignment.prompt, resultFile, { mcp: assignment.mcp });
+    const cmd = buildHeadlessCommand(assignment.cli, assignment.prompt, resultFile, { mcp: assignment.mcp, model: assignment.model });
     startCapture(sessionName, newPaneId);
     // pane 간 pipe-pane EBUSY 방지 — 이벤트 루프 해방하며 순차 대기
     if (i > 0) await new Promise(r => setTimeout(r, 300));
@@ -182,7 +182,7 @@ function dispatchBatch(sessionName, assignments, layout, safeProgress) {
   return assignments.map((assignment, i) => {
     const paneName = `worker-${i + 1}`;
     const resultFile = join(RESULT_DIR, `${sessionName}-${paneName}.txt`).replace(/\\/g, "/");
-    const cmd = buildHeadlessCommand(assignment.cli, assignment.prompt, resultFile, { mcp: assignment.mcp });
+    const cmd = buildHeadlessCommand(assignment.cli, assignment.prompt, resultFile, { mcp: assignment.mcp, model: assignment.model });
     const scriptDir = join(RESULT_DIR, sessionName);
     const dispatch = dispatchCommand(sessionName, paneName, cmd, { scriptDir, scriptName: paneName });