@triflux/remote 10.68.0 → 10.70.0

package/hub/team/agent-map.json

@@ -10,7 +10,7 @@
   "critic": "codex",
   "analyst": "codex",
   "code-reviewer": "codex",
-  "security-reviewer": "codex",
+  "security-reviewer": "antigravity",
   "quality-reviewer": "codex",
   "scientist": "codex",
   "scientist-deep": "codex",

package/hub/team/headless.mjs

@@ -180,7 +180,18 @@ function buildRouteBackedHeadlessCommand(
       ? String(Math.trunc(Number(opts.timeoutSec)))
       : "";
   const timeoutArg = timeout ? ` ${shellQuote(timeout)}` : "";
-  const routeMode = resolvedCli === "antigravity" ? "antigravity" : resolvedCli;
+  const reviewByAuthor = ["code-reviewer", "quality-reviewer"].includes(
+    routeAgent,
+  );
+  const cliModeEnv = reviewByAuthor
+    ? ""
+    : `TFX_CLI_MODE=${shellQuote(resolvedCli)} `;
+  const reviewEnv = reviewByAuthor
+    ? ["TFX_REVIEW_AUTHOR", "TFX_CLI_MODE"]
+        .filter((key) => process.env[key] !== undefined)
+        .map((key) => `${key}=${shellQuote(process.env[key])} `)
+        .join("")
+    : "";
   const codexProfileEnv =
     resolvedCli === "codex" && opts.codexProfile
       ? `TFX_CODEX_PROFILE=${shellQuote(opts.codexProfile)} `
@@ -195,7 +206,7 @@ function buildRouteBackedHeadlessCommand(
     .join("");
   const script =
     `__tfx_prompt=$(cat ${shellQuote(promptFile)}); ` +
-    `${lifecycleEnv}${codexProfileEnv}TFX_CLI_MODE=${shellQuote(routeMode)} ` +
+    `${lifecycleEnv}${codexProfileEnv}${cliModeEnv}${reviewEnv}` +
     `bash ${shellQuote(routeScript)} ${shellQuote(routeAgent)} "$__tfx_prompt" ${shellQuote(mcp)}${timeoutArg} ` +
     `> ${shellQuote(resultFile)} 2>${shellQuote(`${resultFile}.err`)} < /dev/null`;
   return `bash -lc ${shellQuote(script)}`;
@@ -218,6 +229,10 @@ const MCP_PROFILE_HINTS = {
 export function buildHeadlessCommand(cli, prompt, resultFile, opts = {}) {
   const { handoff = true, mcp, contextFile, model, cwd } = opts;
   const resolvedCli = resolveCliType(cli);
+  const routeAgent = opts.role || cli;
+  const reviewByAuthor = ["code-reviewer", "quality-reviewer"].includes(
+    routeAgent,
+  );
 
   // contextFile 처리: 32KB(32768 bytes) 초과 시 UTF-8 안전 절단
   let contextPrefix = "";
@@ -271,9 +286,10 @@ export function buildHeadlessCommand(cli, prompt, resultFile, opts = {}) {
         })
       : undefined;
   const backendCommand =
-    resolvedCli === "codex" || resolvedCli === "antigravity"
+    reviewByAuthor || resolvedCli === "codex" || resolvedCli === "antigravity"
       ? buildRouteBackedHeadlessCommand(resolvedCli, promptFile, resultFile, {
           ...opts,
+          role: reviewByAuthor ? routeAgent : opts.role,
           codexProfile,
           mcp,
         })

package/hub/team/pane.mjs

@@ -1,8 +1,9 @@
 // hub/team/pane.mjs — pane별 CLI 실행 + stdin 주입
 // 의존성: child_process, fs, os, path (Node.js 내장)만 사용
-import { unlinkSync, writeFileSync } from "node:fs";
+import { existsSync, unlinkSync, writeFileSync } from "node:fs";
 import { createRequire } from "node:module";
-import { join } from "node:path";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
 import { privateTmpDir } from "@triflux/core/hub/lib/private-tmp.mjs";
 import { psmuxExec } from "./psmux.mjs";
 import { detectMultiplexer, tmuxExec } from "./session.mjs";
@@ -56,7 +57,32 @@ export function resolveCli(cli) {
  * @param {string} cli: CLI 이름, 별칭(agy) 또는 역할명
  * @returns {string} 실행할 셸 커맨드
  */
-export function buildCliCommand(cli) {
+export function buildCliCommand(cli, prompt) {
+  if (["code-reviewer", "quality-reviewer"].includes(cli)) {
+    // 작성 벤더 선택은 라우터에 맡기고 프롬프트가 준비된 뒤 실행한다.
+    if (prompt === undefined) return "";
+    const routeScript = [
+      process.env.TFX_ROUTE_SCRIPT,
+      process.env.TFX_DELEGATOR_ROUTE_SCRIPT,
+      join(
+        dirname(fileURLToPath(import.meta.url)),
+        "../../scripts/tfx-route.sh",
+      ),
+      join(process.env.HOME || "", ".claude/scripts/tfx-route.sh"),
+    ].find((path) => path && existsSync(path));
+    if (!routeScript) throw new Error("tfx-route.sh 를 찾지 못했다.");
+    const quote = (value) => `'${String(value).replace(/'/g, "'\\''")}'`;
+    const reviewEnv = ["TFX_REVIEW_AUTHOR", "TFX_CLI_MODE"]
+      .filter((key) => process.env[key] !== undefined)
+      .map((key) => `${key}=${quote(process.env[key])} `)
+      .join("");
+    const script = `${reviewEnv}bash ${quote(routeScript.replace(/\\/g, "/"))} ${quote(cli)} ${quote(prompt)} review < /dev/null`;
+    const quotedScript =
+      process.platform === "win32"
+        ? `'${script.replace(/'/g, "''")}'`
+        : quote(script);
+    return `bash -lc ${quotedScript}`;
+  }
   switch (resolveCli(cli)) {
     case "codex":
       return "codex --dangerously-bypass-approvals-and-sandbox";
@@ -78,7 +104,7 @@ export function buildCliCommand(cli) {
  */
 export function startCliInPane(target, command) {
   // CLI 시작도 buffer paste를 재사용해 셸/플랫폼별 quoting 차이를 제거한다.
-  injectPrompt(target, command);
+  if (command) injectPrompt(target, command);
 }
 
 /**
@@ -247,6 +273,11 @@ export function injectPrompt(
   prompt,
   { useFileRef = false, cli = null } = {},
 ) {
+  if (["code-reviewer", "quality-reviewer"].includes(cli)) {
+    prompt = buildCliCommand(cli, prompt);
+    cli = null;
+    useFileRef = false;
+  }
   const tmpDir = privateTmpDir("tfx-multi");
 
   const safeTarget = target.replace(/[:.]/g, "-");

package/hub/workers/claude-worker.mjs

@@ -109,6 +109,8 @@ function buildClaudeArgs(worker, options) {
   args.push("--print");
   args.push("--input-format", "stream-json");
   args.push("--output-format", "stream-json");
+  // Claude Code 2.1.296 은 --print 와 stream-json 출력을 함께 쓰면 --verbose 를 요구한다.
+  args.push("--verbose");
 
   if (options.includePartialMessages) args.push("--include-partial-messages");
   if (options.replayUserMessages) args.push("--replay-user-messages");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@triflux/remote",
-  "version": "10.68.0",
+  "version": "10.70.0",
   "description": "triflux remote — team mode, psmux, MCP workers.",
   "type": "module",
   "main": "hub/index.mjs",

package/scripts/lib/agent-route-policy.mjs

@@ -1,6 +1,8 @@
 // Canonical Codex role policy. Concrete model IDs stay in profile config files.
 
 import { readFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
 import { pathToFileURL } from "node:url";
 import {
   normalizeCodexProfileName,
@@ -298,6 +300,7 @@ const NATIVE_CODEX_AGENTS = new Set([
   "test-engineer",
   "qa-tester",
 ]);
+const CLAUDE_REVIEW_USAGE_THRESHOLD = 80;
 
 function resolveDirectCodexRoutePolicy(agent) {
   if (agent === "explore") {
@@ -315,6 +318,7 @@ export function resolveAgentRoute(
   profileOverride = "auto",
   nested = false,
   geminiProfileResolver = resolveGeminiProfileForPurpose,
+  { reviewAuthor = "codex", weeklyPercent = 0 } = {},
 ) {
   if (!/^[A-Za-z0-9_.-]+$/.test(agent)) {
     throw new Error(`invalid agent: ${agent}`);
@@ -324,10 +328,27 @@ export function resolveAgentRoute(
       `알 수 없는 에이전트 타입: ${agent}; available: ${Object.keys(map).join(", ")}`,
     );
   }
-  const provider = map[agent];
+  let provider = map[agent];
   if (!["codex", "antigravity", "claude"].includes(provider)) {
     throw new Error(`invalid provider for ${agent}: ${provider}`);
   }
+  const byAuthor = agent === "code-reviewer" || agent === "quality-reviewer";
+  let usageSwitch = false;
+  if (byAuthor) {
+    if (!["codex", "claude", "antigravity"].includes(reviewAuthor)) {
+      throw new Error(
+        `TFX_REVIEW_AUTHOR 값이 유효하지 않습니다: ${reviewAuthor}`,
+      );
+    }
+    usageSwitch =
+      reviewAuthor !== "claude" &&
+      Number.isFinite(weeklyPercent) &&
+      weeklyPercent >= CLAUDE_REVIEW_USAGE_THRESHOLD;
+    if (reviewAuthor === "claude") provider = "codex";
+    else if (usageSwitch)
+      provider = reviewAuthor === "codex" ? "antigravity" : "codex";
+    else provider = "claude";
+  }
   const policy = resolveDirectCodexRoutePolicy(agent);
   const normalizedOverride = normalizeCodexProfileName(profileOverride);
   let resolvedOverride = policy.profile;
@@ -354,6 +375,8 @@ export function resolveAgentRoute(
     geminiProfileResolver(agent),
     EXPECTED_DURATION_BY_AGENT[agent] ?? 30,
     NATIVE_CODEX_AGENTS.has(agent),
+    byAuthor ? reviewAuthor : "",
+    usageSwitch,
   ];
 }
 
@@ -402,6 +425,23 @@ async function runCli() {
   if (format === "route") {
     if (!mapFile) throw new Error("--map-file is required for route format");
     const map = JSON.parse(readFileSync(mapFile, "utf8"));
+    let weeklyPercent = 0;
+    if (agent === "code-reviewer" || agent === "quality-reviewer") {
+      try {
+        const data = JSON.parse(
+          readFileSync(
+            join(homedir(), ".claude/cache/claude-usage-cache.json"),
+            "utf8",
+          ),
+        ).data;
+        weeklyPercent =
+          Date.parse(data?.weeklyResetsAt) <= Date.now()
+            ? 0
+            : data?.weeklyPercent;
+      } catch {
+        // 사용량을 읽지 못하면 한도 미만으로 취급한다.
+      }
+    }
     let resolver = resolveGeminiProfileForPurpose;
     if (geminiProfilesModule) {
       try {
@@ -418,9 +458,10 @@ async function runCli() {
       }
     }
     process.stdout.write(
-      resolveAgentRoute(agent, map, profileOverride, nested, resolver).join(
-        "\x1e",
-      ),
+      resolveAgentRoute(agent, map, profileOverride, nested, resolver, {
+        reviewAuthor: process.env.TFX_REVIEW_AUTHOR ?? "codex",
+        weeklyPercent,
+      }).join("\x1e"),
     );
     return;
   }