@triflux/core 10.50.2 → 10.51.0

package/hud/renderers.mjs

@@ -1,8 +1,6 @@
 // ============================================================================
 // 라인 렌더러 (tier별 행 생성)
 // ============================================================================
-import { readdirSync, statSync } from "node:fs";
-import { join } from "node:path";
 import {
   bold,
   CLAUDE_ORANGE,
@@ -12,17 +10,18 @@ import {
   colorByPercent,
   colorByProvider,
   dim,
+  GAUGE_WIDTH,
+  GEMINI_BLUE,
   geminiBlue,
-  green,
-  red,
   yellow,
 } from "./colors.mjs";
 import {
   ACCOUNT_LABEL_WIDTH,
   FIVE_HOUR_MS,
+  ONE_DAY_MS,
+  PERCENT_CELL_WIDTH,
   PROVIDER_PREFIX_WIDTH,
   SEVEN_DAY_MS,
-  TEAM_STATE_DIR,
 } from "./constants.mjs";
 import { buildContextUsageView } from "./context-monitor.mjs";
 import { getTerminalColumns, tierBar, tierDimBar } from "./terminal.mjs";
@@ -36,94 +35,10 @@ import {
   formatTimeCell,
   formatTimeCellDH,
   padAnsiRight,
-  readJson,
   stripAnsi,
   truncateAnsi,
 } from "./utils.mjs";
 
-// ============================================================================
-// tfx-multi 상태 행 생성 (v2.2 HUD 통합)
-// ============================================================================
-export function getTeamRow(currentTier, stateDir = TEAM_STATE_DIR) {
-  let latestPath = null;
-  let latestMtime = Date.now() - 24 * 60 * 60 * 1000;
-  try {
-    for (const name of readdirSync(stateDir)) {
-      if (!/^team-state-.+\.json$/.test(name)) continue;
-      const path = join(stateDir, name);
-      try {
-        const stat = statSync(path);
-        if (stat.isFile() && stat.mtimeMs > latestMtime) {
-          latestPath = path;
-          latestMtime = stat.mtimeMs;
-        }
-      } catch {
-        // 세션 종료 중 사라진 파일은 제외한다.
-      }
-    }
-  } catch {
-    return null;
-  }
-  const teamState = latestPath ? readJson(latestPath, null) : null;
-  if (!teamState?.sessionName) return null;
-
-  const workers = (teamState.members || []).filter((m) => m.role === "worker");
-  if (!workers.length) return null;
-
-  const tasks = teamState.tasks || [];
-  const completed = tasks.filter((t) => t.status === "completed").length;
-  const failed = tasks.filter((t) => t.status === "failed").length;
-  const total = tasks.length || workers.length;
-
-  // 경과 시간 (80col 이상에서만 표시)
-  const elapsed =
-    teamState.startedAt && (currentTier === "full" || currentTier === "compact")
-      ? `${Math.round((Date.now() - teamState.startedAt) / 60000)}m`
-      : "";
-
-  // CLI 브랜드: 단일문자 + ANSI 색상 (x=codex, g=gemini, c=claude)
-  const cliTag = (cli) =>
-    cli === "codex"
-      ? bold(codexWhite("x"))
-      : cli === "gemini"
-        ? bold(geminiBlue("g"))
-        : bold(claudeOrange("c"));
-  // 멤버 상태: 태그 + 상태기호 (60col 이상)
-  const memberIcons =
-    currentTier === "full" ||
-    currentTier === "compact" ||
-    currentTier === "minimal"
-      ? workers
-          .map((m) => {
-            const task = tasks.find((t) => t.owner === m.name);
-            const status =
-              task?.status === "completed"
-                ? green("\u2713")
-                : task?.status === "in_progress"
-                  ? yellow("\u22EF")
-                  : task?.status === "failed"
-                    ? red("\u2717")
-                    : dim("\u25CC");
-            return `${cliTag(m.cli)}${status}`;
-          })
-          .join(" ")
-      : "";
-
-  // 진행 텍스트
-  const doneText =
-    failed > 0
-      ? `${completed}/${total} ${red(`${failed}\u2717`)}`
-      : `${completed}/${total}`;
-
-  const leftText = elapsed ? `${doneText} ${dim(elapsed)}` : doneText;
-
-  return {
-    prefix: bold(claudeOrange("\u25B2")),
-    left: leftText,
-    right: memberIcons,
-  };
-}
-
 // ============================================================================
 // 행 정렬 렌더링
 // ============================================================================
@@ -142,9 +57,7 @@ export function renderAlignedRows(rows) {
     if (!hasRight) {
       return truncateAnsi(`${prefix} ${row.left}`, cols);
     }
-    // 자기 left 대비 패딩 상한: 최대 2칸까지만 패딩 (과도한 공백 방지)
-    const ownLen = stripAnsi(row.left).length;
-    const effectiveWidth = Math.min(rawLeftWidth, ownLen + 2);
+    const effectiveWidth = rawLeftWidth;
     const left = padAnsiRight(row.left, effectiveWidth);
     // 우선순위 기반 truncate: right 먼저 축소, 그래도 넘치면 left 축소
     // prefix(PROVIDER_PREFIX_WIDTH) + " "(1) + left(effectiveWidth) + " | "(3) + right
@@ -169,10 +82,9 @@ export function getMicroLine(
   contextView,
   claudeUsage,
   codexBuckets,
-  antigravityReady,
   options = {},
 ) {
-  const { showCodex = true, showGemini = true } = options;
+  const { showCodex = true, showAntigravity = true } = options;
   const ctxView = contextView || buildContextUsageView({});
   // Claude 5h/1w
   const cF =
@@ -211,15 +123,26 @@ export function getMicroLine(
   if (showCodex) {
     segments.push(`${bold(codexWhite("x"))}${dim(":")}${xVal}`);
   }
-  if (showGemini) {
+  if (showAntigravity) {
+    const marker = options.antigravityQuota ? bold(geminiBlue("a")) : dim("a");
     segments.push(
-      `${bold(geminiBlue(antigravityReady ? "a" : "g"))}${dim(":")}${antigravityReady ? "agy" : dim("--")}`,
+      `${marker}${dim(":")}${antigravityPercentText(options.antigravityQuota)}${options.antigravityQuota?.stale ? dim("*") : ""}`,
     );
   }
   segments.push(`${dim("CTX:")}${contextPercentText(ctxView)}`);
   return truncateAnsi(segments.join(" "), cols);
 }
 
+function antigravityPercentText(quota) {
+  return quota?.usedPercent != null
+    ? colorByProvider(
+        quota.usedPercent,
+        formatPercentCell(quota.usedPercent),
+        geminiBlue,
+      )
+    : dim("--".padStart(PERCENT_CELL_WIDTH));
+}
+
 // context 는 토큰 수 대신 사용률만 보여 준다.
 function contextPercentText(ctxView) {
   const text = ctxView.display === "--" ? "--" : `${ctxView.percent}%`;
@@ -324,7 +247,10 @@ export function getAccountLabel(
   const providerState = accountsState?.providers?.[provider] || {};
   const lastId = providerState.last_selected_id;
   const picked = providerConfig.find((a) => a.id === lastId) ||
-    providerConfig[0] || { id: `${provider}-main`, label: provider };
+    providerConfig[0] || {
+      id: `${provider}-main`,
+      label: provider === "antigravity" ? "agy" : provider,
+    };
   let label = picked.label || picked.id;
   if (codexEmail) label = codexEmail;
   if (label.includes("@")) label = label.split("@")[0];
@@ -347,14 +273,34 @@ export function getProviderRow(
   );
 
   const prefix = `${bold(markerColor(marker))}:`;
-  if (provider === "antigravity" || provider === "gemini") {
+  if (provider === "antigravity") {
+    const usedPercent = realQuota?.usedPercent;
+    const active = usedPercent != null;
+    const quotaPercent = antigravityPercentText(realQuota);
+    const right = `${active ? markerColor(accountLabel) : dim(accountLabel)}${realQuota?.stale ? dim(" [stale]") : ""}`;
+    if (currentTier === "nano" || currentTier === "micro") {
+      return {
+        prefix: active ? prefix : dim(`${marker}:`),
+        left: quotaPercent,
+        right,
+      };
+    }
+    const bar = active
+      ? tierBar(currentTier, usedPercent, GEMINI_BLUE)
+      : currentTier === "full"
+        ? " ".repeat(GAUGE_WIDTH + 1)
+        : "";
+    const reset =
+      (Date.parse(realQuota?.resetTime) - Date.now() >= ONE_DAY_MS
+        ? formatResetRemainingDayHour(realQuota.resetTime)
+        : formatResetRemaining(realQuota?.resetTime)) || "n/a";
+    const showTime = currentTier === "full" || currentTier === "compact";
+    // /usage의 모델별 값에는 5h/1w 식별자가 없으므로 창을 추측하지 않는다.
+    const slot = `${dim("--:")}${bar}${quotaPercent}${showTime ? ` ${dim(formatTimeCell(reset))}` : ""}`;
     return {
-      prefix,
-      left:
-        provider === "antigravity"
-          ? markerColor(realQuota?.currentAbbrev || "agy")
-          : dim("--"),
-      right: accountLabel ? markerColor(accountLabel) : "",
+      prefix: active ? prefix : dim(`${marker}:`),
+      left: `${slot} ${" ".repeat(stripAnsi(slot).length)}`,
+      right,
     };
   }
   const provAnsi = CODEX_WHITE;

package/hud/utils.mjs

@@ -164,10 +164,10 @@ export function formatTimeCell(value) {
   return `(${text.padStart(TIME_CELL_INNER_WIDTH, padChar)})`;
 }
 
-// 주간(d/h) 전용 — 최대 7d00h(5자)이므로 공백 불필요
+// n/a도 정상 주간 시간과 같은 너비를 유지한다.
 export function formatTimeCellDH(value) {
   const text = normalizeTimeToken(value);
-  return `(${text})`;
+  return `(${text.padStart(TIME_CELL_INNER_WIDTH, " ")})`;
 }
 
 export function getCliArgValue(flag) {

package/package.json

@@ -1,13 +1,12 @@
 {
   "name": "@triflux/core",
-  "version": "10.50.2",
+  "version": "10.51.0",
   "description": "triflux core — CLI routing, pipeline, adapters. Zero native dependencies.",
   "type": "module",
   "main": "hub/index.mjs",
   "exports": {
     ".": "./hub/index.mjs",
     "./hub/*": "./hub/*",
-    "./mesh/*": "./mesh/*",
     "./scripts/*": "./scripts/*"
   },
   "engines": {
@@ -21,7 +20,6 @@
   },
   "files": [
     "hub",
-    "mesh",
     "scripts/lib",
     "hooks",
     "hud"

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

@@ -1,9 +1,12 @@
 // Canonical Codex role policy. Concrete model IDs stay in profile config files.
 
+import { readFileSync } from "node:fs";
+import { pathToFileURL } from "node:url";
 import {
   normalizeCodexProfileName,
   resolveCodexProfileConfigValues,
 } from "./codex-profile-config.mjs";
+import { resolveGeminiProfileForPurpose } from "./gemini-profiles.mjs";
 
 const policy = {
   executor: {
@@ -198,7 +201,7 @@ function freezePolicy(entry) {
   return Object.freeze({ ...entry });
 }
 
-export const CODEX_AGENT_POLICY = Object.freeze(
+const CODEX_AGENT_POLICY = Object.freeze(
   Object.fromEntries(
     Object.entries(policy).map(([agent, entry]) => [
       agent,
@@ -206,9 +209,9 @@ export const CODEX_AGENT_POLICY = Object.freeze(
     ]),
   ),
 );
-export const DEFAULT_CODEX_AGENT = "executor";
+const DEFAULT_CODEX_AGENT = "executor";
 
-export const CANONICAL_CODEX_PROFILE_OVERRIDES = Object.freeze(
+const CANONICAL_CODEX_PROFILE_OVERRIDES = Object.freeze(
   new Set([
     "gpt6_luna_low",
     "gpt6_luna_high",
@@ -219,7 +222,7 @@ export const CANONICAL_CODEX_PROFILE_OVERRIDES = Object.freeze(
     "gpt6_astra_ultra",
   ]),
 );
-export const ULTRA_ELIGIBLE_CODEX_AGENTS = Object.freeze(
+const ULTRA_ELIGIBLE_CODEX_AGENTS = Object.freeze(
   new Set(["deep-executor", "scientist-deep"]),
 );
 
@@ -316,31 +319,176 @@ export function resolveNestedCodexAgentProfile(
   return effort.toLowerCase() === "ultra" ? "gpt6_astra_max" : candidate;
 }
 
-export function describeCodexAgentPolicy() {
-  return {
-    defaultAgent: DEFAULT_CODEX_AGENT,
-    agents: Object.keys(CODEX_AGENT_POLICY),
-  };
+const MIN_TIMEOUT_BY_AGENT = Object.freeze({
+  "deep-executor": 900,
+  architect: 900,
+  planner: 900,
+  critic: 900,
+  analyst: 900,
+  "document-specialist": 900,
+  scientist: 900,
+  "scientist-deep": 900,
+  "code-reviewer": 600,
+  "security-reviewer": 600,
+  "quality-reviewer": 600,
+  executor: 300,
+  debugger: 300,
+});
+
+const EXPECTED_DURATION_BY_AGENT = Object.freeze({
+  writer: 90,
+  verifier: 90,
+  "qa-tester": 90,
+  executor: 300,
+  debugger: 300,
+  "test-engineer": 300,
+  "code-reviewer": 600,
+  "security-reviewer": 600,
+  architect: 600,
+  planner: 600,
+  critic: 600,
+  analyst: 600,
+  scientist: 900,
+  "scientist-deep": 900,
+  "deep-executor": 900,
+  "document-specialist": 900,
+});
+
+const NATIVE_CODEX_AGENTS = new Set([
+  "explore",
+  "verifier",
+  "test-engineer",
+  "qa-tester",
+]);
+
+function resolveDirectCodexRoutePolicy(agent) {
+  if (agent === "explore") {
+    return { ...CODEX_AGENT_POLICY.spark, timeoutSec: 600, mcpHint: "analyze" };
+  }
+  if (agent === "antigravity" || agent === "agy") {
+    return CODEX_AGENT_POLICY.designer;
+  }
+  return resolveCodexAgentPolicy(agent);
+}
+
+export function resolveAgentRoute(
+  agent,
+  map,
+  profileOverride = "auto",
+  nested = false,
+  geminiProfileResolver = resolveGeminiProfileForPurpose,
+) {
+  if (!/^[A-Za-z0-9_.-]+$/.test(agent)) {
+    throw new Error(`invalid agent: ${agent}`);
+  }
+  if (!Object.hasOwn(map, agent)) {
+    throw new Error(
+      `알 수 없는 에이전트 타입: ${agent}; available: ${Object.keys(map).join(", ")}`,
+    );
+  }
+  const provider = map[agent];
+  if (!["codex", "antigravity", "claude"].includes(provider)) {
+    throw new Error(`invalid provider for ${agent}: ${provider}`);
+  }
+  const policy = resolveDirectCodexRoutePolicy(agent);
+  const normalizedOverride = normalizeCodexProfileName(profileOverride);
+  let resolvedOverride = policy.profile;
+  if (normalizedOverride !== "auto") {
+    try {
+      resolvedOverride = resolveCodexAgentProfile(agent, {
+        profileOverride: normalizedOverride,
+        nested,
+      });
+    } catch {
+      throw new Error(
+        `TFX_CODEX_PROFILE 값이 유효하지 않습니다: ${profileOverride}`,
+      );
+    }
+  }
+  return [
+    provider,
+    policy.profile,
+    policy.timeoutSec,
+    policy.runMode,
+    policy.opusOversight,
+    policy.mcpHint,
+    policy.subcommand,
+    normalizedOverride,
+    resolvedOverride,
+    geminiProfileResolver(agent),
+    MIN_TIMEOUT_BY_AGENT[agent] ?? 120,
+    EXPECTED_DURATION_BY_AGENT[agent] ?? 30,
+    NATIVE_CODEX_AGENTS.has(agent),
+  ];
 }
 
 function parseCliArgs(argv) {
   const args = [...argv];
   let format = "json";
   let agent = DEFAULT_CODEX_AGENT;
+  let mapFile = "";
+  let profileOverride = "auto";
+  let geminiProfilesModule = "";
+  let nested = false;
   while (args.length > 0) {
     const flag = args.shift();
     if (flag === "--format") format = args.shift() || "";
     else if (flag === "--agent") agent = args.shift() || "";
+    else if (flag === "--map-file") mapFile = args.shift() || "";
+    else if (flag === "--profile-override")
+      profileOverride = args.shift() || "";
+    else if (flag === "--gemini-profiles-module")
+      geminiProfilesModule = args.shift() || "";
+    else if (flag === "--nested") nested = true;
     else throw new Error(`unknown argument: ${flag}`);
   }
-  if (!new Set(["json", "tsv"]).has(format)) {
+  if (!new Set(["json", "tsv", "route"]).has(format)) {
     throw new Error(`unsupported format: ${format}`);
   }
-  return { format, agent };
+  return {
+    format,
+    agent,
+    mapFile,
+    profileOverride,
+    geminiProfilesModule,
+    nested,
+  };
 }
 
-function runCli() {
-  const { format, agent } = parseCliArgs(process.argv.slice(2));
+async function runCli() {
+  const {
+    format,
+    agent,
+    mapFile,
+    profileOverride,
+    geminiProfilesModule,
+    nested,
+  } = parseCliArgs(process.argv.slice(2));
+  if (format === "route") {
+    if (!mapFile) throw new Error("--map-file is required for route format");
+    const map = JSON.parse(readFileSync(mapFile, "utf8"));
+    let resolver = resolveGeminiProfileForPurpose;
+    if (geminiProfilesModule) {
+      try {
+        const module = await import(pathToFileURL(geminiProfilesModule).href);
+        resolver = (agent) => {
+          try {
+            return module.resolveGeminiProfileForPurpose(agent) || "flash38";
+          } catch {
+            return "flash38";
+          }
+        };
+      } catch {
+        resolver = () => "flash38";
+      }
+    }
+    process.stdout.write(
+      resolveAgentRoute(agent, map, profileOverride, nested, resolver).join(
+        "\x1e",
+      ),
+    );
+    return;
+  }
   const resolved = resolveCodexAgentPolicy(agent);
   if (format === "tsv") {
     process.stdout.write(
@@ -360,7 +508,7 @@ function runCli() {
 
 if (import.meta.url === new URL(process.argv[1], "file:").href) {
   try {
-    runCli();
+    await runCli();
   } catch (error) {
     process.stderr.write(`[agent-route-policy] ${error.message}\n`);
     process.exitCode = 1;