@triflux/core 10.44.0 → 10.45.0

package/hud/renderers.mjs

@@ -22,11 +22,9 @@ import {
 import {
   ACCOUNT_LABEL_WIDTH,
   FIVE_HOUR_MS,
-  LEGACY_SV_ACCUMULATOR,
   ONE_DAY_MS,
   PROVIDER_PREFIX_WIDTH,
   SEVEN_DAY_MS,
-  SV_ACCUMULATOR_PATH,
   TEAM_STATE_PATH,
 } from "./constants.mjs";
 import { buildContextUsageView } from "./context-monitor.mjs";
@@ -40,13 +38,11 @@ import {
   formatResetRemaining,
   formatResetRemainingDayHour,
   formatSavings,
-  formatSvPct,
   formatTimeCell,
   formatTimeCellDH,
   formatTokenCount,
   padAnsiRight,
   readJson,
-  readJsonMigrate,
   stripAnsi,
   truncateAnsi,
 } from "./utils.mjs";
@@ -88,25 +84,6 @@ export function readLatestBenchmarkDiff() {
   }
 }
 
-// 토큰 절약액 누적치 읽기 (tfx-auto token tracker)
-export function readTokenSavings() {
-  const savingsPath = join(
-    homedir(),
-    ".omc",
-    "state",
-    "tfx-auto-tokens",
-    "savings-total.json",
-  );
-  const data = readJson(savingsPath, null);
-  if (!data || data.totalSaved === 0) return null;
-  return data;
-}
-
-// sv-accumulator.json에서 누적 토큰/비용 읽기
-export function readSvAccumulator() {
-  return readJsonMigrate(SV_ACCUMULATOR_PATH, LEGACY_SV_ACCUMULATOR, null);
-}
-
 /**
  * 파이프라인 벤치마크 diff 결과를 HUD 요약 문자열로 포맷
  */
@@ -279,9 +256,12 @@ export function getMicroLine(
   codexBuckets,
   geminiSession,
   geminiBucket,
-  combinedSvPct,
   geminiMarker = "g",
+  options = {},
 ) {
+  // showCodex / showGemini 는 machine profile 의 TFX_DISABLE_* 게이트다. 기본값이
+  // true 라 8번째 인자를 주지 않는 기존 호출은 그대로 동작한다.
+  const { showCodex = true, showGemini = true } = options;
   const ctxView = contextView || buildContextUsageView({}, null);
   // Claude 5h/1w
   const cF =
@@ -325,34 +305,27 @@ export function getMicroLine(
     gVal = dim("--");
   }
 
-  // sv
-  const sv = formatSvPct(combinedSvPct).trim();
-
   const cols = getTerminalColumns() || 120;
-  const line =
-    `${bold(claudeOrange("c"))}${dim(":")}${cVal} ` +
-    `${bold(codexWhite("x"))}${dim(":")}${xVal} ` +
-    `${bold(geminiBlue(geminiMarker))}${dim(":")}${gVal} ` +
-    `${dim("sv:")}${sv} ` +
-    `${dim("CTX:")}${colorByPercent(ctxView.percent, ctxView.display)}`;
-  return truncateAnsi(line, cols);
+  // 세그먼트를 모아 join 한다. 차단된 프로바이더를 뺄 때 공백이 겹치지 않는다.
+  const segments = [`${bold(claudeOrange("c"))}${dim(":")}${cVal}`];
+  if (showCodex) {
+    segments.push(`${bold(codexWhite("x"))}${dim(":")}${xVal}`);
+  }
+  if (showGemini) {
+    segments.push(`${bold(geminiBlue(geminiMarker))}${dim(":")}${gVal}`);
+  }
+  segments.push(
+    `${dim("CTX:")}${colorByPercent(ctxView.percent, ctxView.display)}`,
+  );
+  return truncateAnsi(segments.join(" "), cols);
 }
 
 // ============================================================================
 // Claude 행 렌더러
 // ============================================================================
-export function getClaudeRows(
-  currentTier,
-  contextView,
-  claudeUsage,
-  combinedSvPct,
-) {
+export function getClaudeRows(currentTier, contextView, claudeUsage) {
   const ctxView = contextView || buildContextUsageView({}, null);
   const prefix = `${bold(claudeOrange("c"))}:`;
-  // 절약 퍼센트
-  const svStr = formatSvPct(combinedSvPct);
-  const svSuffix = `${dim("sv:")}${svStr}`;
-
   // API 실측 데이터
   const fiveHourPercent = claudeUsage?.fiveHourPercent ?? null;
   const weeklyPercent = claudeUsage?.weeklyPercent ?? null;
@@ -418,7 +391,7 @@ export function getClaudeRows(
     const warning = ctxView.warningTag
       ? ` ${dim("|")} ${yellow(ctxView.warningTag)}`
       : "";
-    const contextSection = `${svSuffix} ${dim("|")} ${dim("CTX:")}${colorByPercent(ctxView.percent, ctxView.display)}${warning}`;
+    const contextSection = `${dim("CTX:")}${colorByPercent(ctxView.percent, ctxView.display)}${warning}`;
     return [{ prefix, left: quotaSection, right: contextSection }];
   }
 
@@ -428,7 +401,7 @@ export function getClaudeRows(
   const warning = ctxView.warningTag
     ? ` ${dim("|")} ${yellow(ctxView.warningTag)}`
     : "";
-  const contextSection = `${svSuffix} ${dim("|")} ${dim("CTX:")}${colorByPercent(ctxView.percent, ctxView.display)}${warning}`;
+  const contextSection = `${dim("CTX:")}${colorByPercent(ctxView.percent, ctxView.display)}${warning}`;
   return [{ prefix, left: quotaSection, right: contextSection }];
 }
 
@@ -513,7 +486,6 @@ export function getProviderRow(
   accountsState,
   realQuota,
   codexEmail,
-  savingsMultiplier,
   modelLabel,
 ) {
   const accountLabel = fitText(
@@ -521,10 +493,6 @@ export function getProviderRow(
     ACCOUNT_LABEL_WIDTH,
   );
 
-  // 절약 퍼센트 섹션
-  const svPct =
-    savingsMultiplier != null ? Math.round(savingsMultiplier * 100) : null;
-  const svStr = formatSvPct(svPct);
   const _modelLabelStr = modelLabel ? ` ${markerColor(modelLabel)}` : "";
 
   // 프로바이더별 색상 프로필
@@ -708,10 +676,7 @@ export function getProviderRow(
       quotaSection = `${dim("5h:")}${dim(formatPlaceholderPercentCell())} ${dim(formatTimeCell("n/a"))} ${dim("1w:")}${dim(formatPlaceholderPercentCell())} ${dim(formatTimeCellDH("--d--h"))}`;
     }
     const prefix = `${bold(markerColor(`${marker}`))}:`;
-    const compactRight = [
-      svStr ? `${dim("sv:")}${svStr}` : "",
-      accountLabel ? markerColor(accountLabel) : "",
-    ]
+    const compactRight = [accountLabel ? markerColor(accountLabel) : ""]
       .filter(Boolean)
       .join(" ");
     return { prefix, left: quotaSection, right: compactRight };
@@ -800,11 +765,8 @@ export function getProviderRow(
 
   const prefix = `${bold(markerColor(`${marker}`))}:`;
   const accountSection = `${markerColor(accountLabel)}`;
-  const svSection = svStr ? `${dim("sv:")}${svStr}` : "";
   const modelLabelSection = modelLabel ? markerColor(modelLabel) : "";
-  const rightParts = [svSection, accountSection, modelLabelSection].filter(
-    Boolean,
-  );
+  const rightParts = [accountSection, modelLabelSection].filter(Boolean);
   return {
     prefix,
     left: quotaSection,

package/hud/utils.mjs

@@ -5,11 +5,7 @@
 import { createHash } from "node:crypto";
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
 import { dirname } from "node:path";
-import {
-  PERCENT_CELL_WIDTH,
-  SV_CELL_WIDTH,
-  TIME_CELL_INNER_WIDTH,
-} from "./constants.mjs";
+import { PERCENT_CELL_WIDTH, TIME_CELL_INNER_WIDTH } from "./constants.mjs";
 
 export async function readStdinJson() {
   if (process.stdin.isTTY) return {};
@@ -338,16 +334,6 @@ export function createHttpsPost(https, timeoutMs) {
   };
 }
 
-// sv 퍼센트 포맷 (1000+ → k 표기, 5자 고정폭)
-export function formatSvPct(value) {
-  if (value == null) return "--%".padStart(SV_CELL_WIDTH);
-  if (value >= 10000)
-    return `${Math.round(value / 1000)}k%`.padStart(SV_CELL_WIDTH);
-  if (value >= 1000)
-    return `${(value / 1000).toFixed(1)}k%`.padStart(SV_CELL_WIDTH);
-  return `${value}%`.padStart(SV_CELL_WIDTH);
-}
-
 export function formatSavings(dollars) {
   if (dollars >= 100) return `$${Math.round(dollars)}`;
   if (dollars >= 10) return `$${dollars.toFixed(1)}`;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@triflux/core",
-  "version": "10.44.0",
+  "version": "10.45.0",
   "description": "triflux core — CLI routing, pipeline, adapters. Zero native dependencies.",
   "type": "module",
   "main": "hub/index.mjs",

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

@@ -1,6 +1,9 @@
 // Canonical Codex role policy. Concrete model IDs stay in profile config files.
 
-import { resolveCodexProfileConfigValues } from "./codex-profile-config.mjs";
+import {
+  normalizeCodexProfileName,
+  resolveCodexProfileConfigValues,
+} from "./codex-profile-config.mjs";
 
 const policy = {
   executor: {
@@ -44,7 +47,7 @@ const policy = {
     subcommand: "exec",
   },
   debugger: {
-    profile: "gpt56_sol_xhigh",
+    profile: "gpt6_astra_xhigh",
     timeoutSec: 900,
     runMode: "bg",
     opusOversight: false,
@@ -52,7 +55,7 @@ const policy = {
     subcommand: "exec",
   },
   "deep-executor": {
-    profile: "gpt56_sol_xhigh",
+    profile: "gpt6_astra_xhigh",
     timeoutSec: 3600,
     runMode: "bg",
     opusOversight: true,
@@ -60,7 +63,7 @@ const policy = {
     subcommand: "exec",
   },
   architect: {
-    profile: "gpt56_sol_xhigh",
+    profile: "gpt6_astra_xhigh",
     timeoutSec: 3600,
     runMode: "bg",
     opusOversight: true,
@@ -68,7 +71,7 @@ const policy = {
     subcommand: "exec",
   },
   critic: {
-    profile: "gpt56_sol_xhigh",
+    profile: "gpt6_astra_xhigh",
     timeoutSec: 3600,
     runMode: "bg",
     opusOversight: true,
@@ -76,7 +79,7 @@ const policy = {
     subcommand: "exec",
   },
   planner: {
-    profile: "gpt56_sol_xhigh",
+    profile: "gpt6_astra_xhigh",
     timeoutSec: 3600,
     runMode: "fg",
     opusOversight: true,
@@ -84,7 +87,7 @@ const policy = {
     subcommand: "exec",
   },
   analyst: {
-    profile: "gpt56_sol_xhigh",
+    profile: "gpt6_astra_xhigh",
     timeoutSec: 3600,
     runMode: "fg",
     opusOversight: true,
@@ -108,7 +111,7 @@ const policy = {
     subcommand: "review",
   },
   "security-reviewer": {
-    profile: "gpt56_sol_xhigh",
+    profile: "gpt6_astra_xhigh",
     timeoutSec: 1800,
     runMode: "bg",
     opusOversight: true,
@@ -132,7 +135,7 @@ const policy = {
     subcommand: "exec",
   },
   "scientist-deep": {
-    profile: "gpt56_sol_xhigh",
+    profile: "gpt6_astra_xhigh",
     timeoutSec: 3600,
     runMode: "bg",
     opusOversight: false,
@@ -174,7 +177,7 @@ const policy = {
   // These entries are only for explicit direct-Codex overrides. agent-map.json
   // remains the provider-selection authority for their normal execution.
   designer: {
-    profile: "gpt56_sol_xhigh",
+    profile: "gpt6_astra_xhigh",
     timeoutSec: 900,
     runMode: "bg",
     opusOversight: false,
@@ -210,9 +213,9 @@ export const CANONICAL_CODEX_PROFILE_OVERRIDES = Object.freeze(
     "gpt56_luna_low",
     "gpt56_terra_med",
     "gpt56_terra_high",
-    "gpt56_sol_xhigh",
-    "gpt56_sol_max",
-    "gpt56_sol_ultra",
+    "gpt6_astra_xhigh",
+    "gpt6_astra_max",
+    "gpt6_astra_ultra",
   ]),
 );
 export const ULTRA_ELIGIBLE_CODEX_AGENTS = Object.freeze(
@@ -222,8 +225,8 @@ export const ULTRA_ELIGIBLE_CODEX_AGENTS = Object.freeze(
 const NESTED_GLOBAL_PROFILE_OVERRIDES = new Set([
   "max",
   "ultra",
-  "gpt56_sol_max",
-  "gpt56_sol_ultra",
+  "gpt6_astra_max",
+  "gpt6_astra_ultra",
 ]);
 
 export function resolveCodexAgentPolicy(agent) {
@@ -251,14 +254,16 @@ export function resolveCodexAgentProfile(
 ) {
   const defaultProfile = resolveCodexAgentPolicy(agent).profile;
   const retryRequested = String(retryProfile ?? "").trim();
-  const requested = retryRequested || String(profileOverride || "auto").trim();
+  const requested = normalizeCodexProfileName(
+    retryRequested || String(profileOverride || "auto").trim(),
+  );
   if (!requested || requested === "auto") return defaultProfile;
 
   const canonical =
     requested === "max"
-      ? "gpt56_sol_max"
+      ? "gpt6_astra_max"
       : requested === "ultra"
-        ? "gpt56_sol_ultra"
+        ? "gpt6_astra_ultra"
         : requested;
   if (!CANONICAL_CODEX_PROFILE_OVERRIDES.has(canonical)) {
     if (allowCustom) return requested;
@@ -266,9 +271,9 @@ export function resolveCodexAgentProfile(
       `[agent-route-policy] unsupported profile override: ${requested}`,
     );
   }
-  if (canonical !== "gpt56_sol_ultra") return canonical;
+  if (canonical !== "gpt6_astra_ultra") return canonical;
   return nested || !ULTRA_ELIGIBLE_CODEX_AGENTS.has(agent)
-    ? "gpt56_sol_max"
+    ? "gpt6_astra_max"
     : canonical;
 }
 
@@ -287,7 +292,9 @@ export function resolveNestedCodexAgentProfile(
   } = {},
 ) {
   const explicitProfile = String(profileOverride || "auto").trim();
-  const globalOverride = String(globalProfile || "auto").trim();
+  const globalOverride = normalizeCodexProfileName(
+    String(globalProfile || "auto").trim(),
+  );
   // Headless lanes must select their role policy explicitly. Only the max and
   // ultra exception lanes may cross the process environment boundary.
   const effectiveOverride =
@@ -305,7 +312,7 @@ export function resolveNestedCodexAgentProfile(
   });
   const { effort } = resolveCodexProfileConfigValues(candidate, { codexHome });
   if (!effort) return fallback;
-  return effort.toLowerCase() === "ultra" ? "gpt56_sol_max" : candidate;
+  return effort.toLowerCase() === "ultra" ? "gpt6_astra_max" : candidate;
 }
 
 export function describeCodexAgentPolicy() {

package/scripts/lib/cli-agy.mjs

@@ -1,12 +1,18 @@
 // cli-agy.mjs — Antigravity (agy) CLI adapter (Phase 0 PoC).
 //
-// 책임: agy --print 는 stdin-only 이므로 plan() 에서 stdinMode="pipe" 시그널을 반환한다.
-// positional prompt 패턴은 환영 메시지 폴백을 유발하므로 사용 금지.
+// 책임: agy 1.1.27 부터 --print 는 값(프롬프트)이 필수이고 stdin 프롬프트는 거부되므로
+// plan() 은 프롬프트를 args 의 --print 값으로 넣고 stdinMode="argv" 를 돌려준다.
+// --print 뒤에 다른 플래그가 오면 그 플래그를 프롬프트로 삼키므로 항상 마지막에 둔다.
 //
 // 출처: scripts/tfx-route.sh route_agent() L1052-L1059, run_codex_exec() L2036-L2046.
 //        .claude/rules/tfx-update-logic.md Antigravity CLI 1.0.0 정밀 sanity matrix.
 // timeoutSec은 lane 예상 소요 시간(advisory)이다. hard ceiling 집행은 Bash route가 소유한다.
 
+import {
+  resolveGeminiModel,
+  resolveGeminiProfileForPurpose,
+} from "./gemini-profiles.mjs";
+
 export const id = "agy";
 export const cliType = "antigravity";
 export const command = "agy";
@@ -38,6 +44,7 @@ export function plan({
   mcpProfile = "auto",
   timeoutSec,
   contextFile,
+  geminiProfilesPath,
 } = {}) {
   if (!agent) {
     throw new Error("[cli-agy] agent required");
@@ -49,8 +56,21 @@ export function plan({
     command,
     profile: cfg.profile,
     effort: cfg.profile,
-    args: ["--print", "--dangerously-skip-permissions"],
-    stdinMode: "pipe",
+    // effort 는 역할별 SSOT(gemini-profiles.mjs): designer → High, writer → Medium ...
+    geminiProfile: resolveGeminiProfileForPurpose(agent),
+    model: resolveGeminiModel(resolveGeminiProfileForPurpose(agent), {
+      profilesPath: geminiProfilesPath,
+    }),
+    args: [
+      "--dangerously-skip-permissions",
+      "--model",
+      resolveGeminiModel(resolveGeminiProfileForPurpose(agent), {
+        profilesPath: geminiProfilesPath,
+      }),
+      "--print",
+      prompt,
+    ],
+    stdinMode: "argv",
     timeoutMs: effectiveTimeoutSec * 1000,
     runMode: cfg.runMode,
     opusOversight: cfg.opusOversight,

package/scripts/lib/codex-profile-config.mjs

@@ -22,11 +22,22 @@ const CANONICAL_PROFILE_VALUES = Object.freeze({
   gpt56_luna_low: { model: "gpt-5.6-luna", effort: "low" },
   gpt56_terra_med: { model: "gpt-5.6-terra", effort: "medium" },
   gpt56_terra_high: { model: "gpt-5.6-terra", effort: "high" },
-  gpt56_sol_xhigh: { model: "gpt-5.6-sol", effort: "xhigh" },
-  gpt56_sol_max: { model: "gpt-5.6-sol", effort: "max" },
-  gpt56_sol_ultra: { model: "gpt-5.6-sol", effort: "ultra" },
+  gpt6_astra_xhigh: { model: "gpt-6-astra", effort: "xhigh" },
+  gpt6_astra_max: { model: "gpt-6-astra", effort: "max" },
+  gpt6_astra_ultra: { model: "gpt-6-astra", effort: "ultra" },
 });
 
+const LEGACY_CANONICAL_PROFILE_ALIASES = Object.freeze({
+  gpt56_sol_xhigh: "gpt6_astra_xhigh",
+  gpt56_sol_max: "gpt6_astra_max",
+  gpt56_sol_ultra: "gpt6_astra_ultra",
+});
+
+export function normalizeCodexProfileName(profileName) {
+  const normalized = String(profileName ?? "").trim();
+  return LEGACY_CANONICAL_PROFILE_ALIASES[normalized] || normalized;
+}
+
 function readProfileScalar(raw, key) {
   const match = String(raw).match(
     new RegExp(
@@ -64,32 +75,39 @@ export function resolveCodexProfileConfigValues(profileName, opts = {}) {
   if (typeof profileName !== "string" || !profileName) {
     return { model: null, effort: null };
   }
+  const normalizedProfileName = normalizeCodexProfileName(profileName);
   const codexHome =
     opts.codexHome || process.env.CODEX_HOME || join(homedir(), ".codex");
   let model = null;
   let effort = null;
   try {
     const raw = readFileSync(
-      join(codexHome, `${profileName}.config.toml`),
+      join(codexHome, `${normalizedProfileName}.config.toml`),
       "utf8",
     );
     model = readProfileScalar(raw, "model");
     effort = readProfileScalar(raw, "model_reasoning_effort");
   } catch {
-    const suffix = /_(ultra|max|xhigh|high|med|medium|low)$/.exec(profileName);
+    const suffix = /_(ultra|max|xhigh|high|med|medium|low)$/.exec(
+      normalizedProfileName,
+    );
     if (suffix) effort = EFFORT_BY_SUFFIX[suffix[1]] || null;
   }
   return { model, effort };
 }
 
 export function codexProfileConfigOverrides(profileName, opts = {}) {
-  let { model, effort } = resolveCodexProfileConfigValues(profileName, opts);
+  const normalizedProfileName = normalizeCodexProfileName(profileName);
+  let { model, effort } = resolveCodexProfileConfigValues(
+    normalizedProfileName,
+    opts,
+  );
   if (opts.enforceCanonicalProfile === true) {
-    const canonical = CANONICAL_PROFILE_VALUES[profileName];
+    const canonical = CANONICAL_PROFILE_VALUES[normalizedProfileName];
     if (canonical) ({ model, effort } = canonical);
   }
   if (opts.disallowUltra === true && effort?.toLowerCase() === "ultra") {
-    model = "gpt-5.6-sol";
+    model = "gpt-6-astra";
     effort = "max";
   }
   const overrides = [];

package/scripts/lib/gemini-profiles.mjs

@@ -8,48 +8,124 @@ import {
 import { homedir } from "node:os";
 import { join } from "node:path";
 
-// 모델명 SSOT. 값은 agy 1.0.x `agy models` 가 출력하는 display name 형식이다
+// 모델명 SSOT. 값은 `agy models` 가 출력하는 display name 형식이다
 // (`--model` 인자가 이 문자열을 받는다). 옛 `gemini-*-preview` ID 형식이 아님.
+// 카탈로그 확인: agy 1.1.27 `agy models` (2026-09-07). 운영 정책은 3.8 Flash 한 세대만
+// 쓰고 effort(Low/Medium/High)로 차등한다. Pro 와 이전 세대 Flash 는 기본 프로필에서 뺐다.
 const DEFAULT_GEMINI_PROFILES = {
-  model: "Gemini 3.5 Flash (Medium)",
+  model: "Gemini 3.8 Flash (Medium)",
   profiles: {
-    flash35_low: {
-      model: "Gemini 3.5 Flash (Low)",
-      hint: "3.5 Flash (Low) — 경량·저비용",
+    flash38_low: {
+      model: "Gemini 3.8 Flash (Low)",
+      hint: "3.8 Flash (Low) — 경량·저비용",
     },
-    flash35: {
-      model: "Gemini 3.5 Flash (Medium)",
-      hint: "3.5 Flash (Medium) — 기본, 비용·속도 균형",
+    flash38: {
+      model: "Gemini 3.8 Flash (Medium)",
+      hint: "3.8 Flash (Medium) — 기본, 비용·속도 균형",
     },
-    flash35_high: {
-      model: "Gemini 3.5 Flash (High)",
-      hint: "3.5 Flash (High) — 코드/추론 강화",
-    },
-    pro31_low: {
-      model: "Gemini 3.1 Pro (Low)",
-      hint: "3.1 Pro (Low) — 플래그십 경량",
-    },
-    pro31: {
-      model: "Gemini 3.1 Pro (High)",
-      hint: "3.1 Pro (High) — 플래그십 최고 (긴 컨텍스트/복잡 추론)",
-    },
-    flash3: {
-      model: "Gemini 3 Flash",
-      hint: "3.0 Flash — 레거시 호환",
+    flash38_high: {
+      model: "Gemini 3.8 Flash (High)",
+      hint: "3.8 Flash (High) — 코드/추론 강화",
     },
   },
 };
 
 // 1회 마이그레이션 테이블: 옛 ID 형식 모델값 → agy display name.
-// null = deprecated(2.5 계열) → 해당 프로필 제거 대상.
+// null = 카탈로그에서 빠진 모델(2.5 계열, 3 Flash) → 해당 프로필 제거 대상.
 const LEGACY_MODEL_MIGRATION = {
   "gemini-3.1-pro-preview": "Gemini 3.1 Pro (High)",
-  "gemini-3-flash-preview": "Gemini 3 Flash",
+  "gemini-3-flash-preview": null,
+  "Gemini 3 Flash": null,
   "gemini-2.5-pro": null,
   "gemini-2.5-flash": null,
   "gemini-2.5-flash-lite": null,
 };
-const LEGACY_PROFILE_NAMES = ["pro25", "flash25", "lite25"];
+// 과거 setup 이 자동 생성했던 프로필 이름. 정책상 더 쓰지 않으므로 제거한다.
+// 사용자가 직접 이름 붙인 프로필은 건드리지 않는다.
+const LEGACY_PROFILE_NAMES = [
+  "pro25",
+  "flash25",
+  "lite25",
+  "flash3",
+  "pro31",
+  "pro31_low",
+  "flash35",
+  "flash35_high",
+  "flash35_low",
+];
+// 과거 setup 이 자동 생성한 기본 model 값. 사용자가 고른 값이 아니므로 새 기본으로 올린다.
+const LEGACY_DEFAULT_MODELS = new Set(["Gemini 3.5 Flash (Medium)"]);
+
+// ── 용도별 effort (SSOT) ──
+// 한 세대(3.8 Flash)만 쓰고 역할에 따라 effort 를 나눈다. 키는 tfx 에이전트/역할 이름
+// (agent-map.json 의 에이전트, tfx multi --assign 의 role). bash(tfx-route.sh)와
+// node(execution-mode, gemini-adapter, cli-agy)가 모두 이 표를 읽는다.
+//   High   : 판단이 결과를 좌우하는 역할 (검토, 설계, 디버깅, 분석)
+//   Medium : 생성/작성/실행 (기본값)
+//   Low    : 분류, 요약, 추출, 번역처럼 짧고 기계적인 작업
+const GEMINI_PROFILE_BY_PURPOSE = Object.freeze({
+  designer: "flash38_high",
+  reviewer: "flash38_high",
+  "code-reviewer": "flash38_high",
+  "security-reviewer": "flash38_high",
+  "quality-reviewer": "flash38_high",
+  critic: "flash38_high",
+  architect: "flash38_high",
+  verifier: "flash38_high",
+  analyst: "flash38_high",
+  debugger: "flash38_high",
+  planner: "flash38_high",
+  scientist: "flash38_high",
+  "test-engineer": "flash38_high",
+  writer: "flash38",
+  executor: "flash38",
+  worker: "flash38",
+  "document-specialist": "flash38",
+  researcher: "flash38",
+  antigravity: "flash38",
+  agy: "flash38",
+  gemini: "flash38",
+  summarizer: "flash38_low",
+  classifier: "flash38_low",
+  triage: "flash38_low",
+  translator: "flash38_low",
+  formatter: "flash38_low",
+  explore: "flash38_low",
+});
+const GEMINI_DEFAULT_PURPOSE_PROFILE = "flash38";
+
+function resolveGeminiProfileForPurpose(name) {
+  const key = String(name ?? "")
+    .trim()
+    .toLowerCase();
+  return GEMINI_PROFILE_BY_PURPOSE[key] || GEMINI_DEFAULT_PURPOSE_PROFILE;
+}
+
+// 프로필 이름 → agy display name. 사용자 파일(~/.gemini/triflux-profiles.json)이
+// 우선하고, 없으면 DEFAULT_GEMINI_PROFILES 로 떨어진다. 이미 모델명이면 그대로 돌려준다.
+function resolveGeminiModel(profileOrModel, opts = {}) {
+  const raw = String(profileOrModel ?? "").trim();
+  if (!raw) return DEFAULT_GEMINI_PROFILES.model;
+  if (/^gemini[\s-]/i.test(raw)) return raw;
+  const profilesPath =
+    opts.profilesPath ||
+    process.env.GEMINI_PROFILES_PATH ||
+    join(homedir(), ".gemini", "triflux-profiles.json");
+  let cfg = null;
+  try {
+    cfg = JSON.parse(readFileSync(profilesPath, "utf8"));
+  } catch {
+    cfg = null;
+  }
+  const entry = cfg?.profiles?.[raw];
+  const fromFile = typeof entry === "string" ? entry : entry?.model;
+  if (typeof fromFile === "string" && fromFile.trim()) return fromFile.trim();
+  const fromDefault = DEFAULT_GEMINI_PROFILES.profiles[raw];
+  if (fromDefault) return fromDefault.model;
+  if (typeof cfg?.model === "string" && cfg.model.trim())
+    return cfg.model.trim();
+  return DEFAULT_GEMINI_PROFILES.model;
+}
 
 const DEFAULT_PROFILE_COUNT = Object.keys(
   DEFAULT_GEMINI_PROFILES.profiles,
@@ -132,9 +208,10 @@ function ensureGeminiProfiles({
     }
     if (
       typeof cfg.model === "string" &&
-      Object.hasOwn(LEGACY_MODEL_MIGRATION, cfg.model)
+      (Object.hasOwn(LEGACY_MODEL_MIGRATION, cfg.model) ||
+        LEGACY_DEFAULT_MODELS.has(cfg.model))
     ) {
-      // 옛 ID 형식 기본값은 구버전 자동 생성값이므로 새 기본(DEFAULT)으로 정규화한다.
+      // 옛 ID 형식/이전 세대 자동 생성 기본값은 새 기본(DEFAULT)으로 정규화한다.
       cfg.model = DEFAULT_GEMINI_PROFILES.model;
       migrated = true;
     }
@@ -180,4 +257,11 @@ function ensureGeminiProfiles({
   }
 }
 
-export { DEFAULT_GEMINI_PROFILES, ensureGeminiProfiles };
+export {
+  DEFAULT_GEMINI_PROFILES,
+  ensureGeminiProfiles,
+  GEMINI_DEFAULT_PURPOSE_PROFILE,
+  GEMINI_PROFILE_BY_PURPOSE,
+  resolveGeminiModel,
+  resolveGeminiProfileForPurpose,
+};