@triflux/remote 10.44.0 → 10.45.0

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,
@@ -207,15 +210,23 @@ export const DEFAULT_CODEX_AGENT = "executor";
 
 export const CANONICAL_CODEX_PROFILE_OVERRIDES = Object.freeze(
   new Set([
-    "gpt56_luna_low", "gpt56_terra_med", "gpt56_terra_high", "gpt56_sol_xhigh",
-    "gpt56_sol_max", "gpt56_sol_ultra",
+    "gpt56_luna_low",
+    "gpt56_terra_med",
+    "gpt56_terra_high",
+    "gpt6_astra_xhigh",
+    "gpt6_astra_max",
+    "gpt6_astra_ultra",
   ]),
 );
 export const ULTRA_ELIGIBLE_CODEX_AGENTS = Object.freeze(
   new Set(["deep-executor", "scientist-deep"]),
 );
+
 const NESTED_GLOBAL_PROFILE_OVERRIDES = new Set([
-  "max", "ultra", "gpt56_sol_max", "gpt56_sol_ultra",
+  "max",
+  "ultra",
+  "gpt6_astra_max",
+  "gpt6_astra_ultra",
 ]);
 
 export function resolveCodexAgentPolicy(agent) {
@@ -224,35 +235,84 @@ export function resolveCodexAgentPolicy(agent) {
   );
 }
 
+/**
+ * Resolves a requested Codex profile against the canonical role policy.
+ *
+ * `retryProfile` intentionally wins over `profileOverride`: retry snapshots
+ * represent an already-selected escalation step and must not be replaced by a
+ * later process-level `TFX_CODEX_PROFILE`. Ultra is reserved for an eligible
+ * top-level role; every nested/sandboxed or ineligible request is max.
+ */
 export function resolveCodexAgentProfile(
   agent,
-  { profileOverride = "auto", retryProfile = null, nested = false, allowCustom = false } = {},
+  {
+    profileOverride = "auto",
+    retryProfile = null,
+    nested = false,
+    allowCustom = false,
+  } = {},
 ) {
   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" : requested === "ultra" ? "gpt56_sol_ultra" : requested;
+
+  const canonical =
+    requested === "max"
+      ? "gpt6_astra_max"
+      : requested === "ultra"
+        ? "gpt6_astra_ultra"
+        : requested;
   if (!CANONICAL_CODEX_PROFILE_OVERRIDES.has(canonical)) {
     if (allowCustom) return requested;
-    throw new Error(`[agent-route-policy] unsupported profile override: ${requested}`);
+    throw new Error(
+      `[agent-route-policy] unsupported profile override: ${requested}`,
+    );
   }
-  if (canonical !== "gpt56_sol_ultra") return canonical;
-  return nested || !ULTRA_ELIGIBLE_CODEX_AGENTS.has(agent) ? "gpt56_sol_max" : canonical;
+  if (canonical !== "gpt6_astra_ultra") return canonical;
+  return nested || !ULTRA_ELIGIBLE_CODEX_AGENTS.has(agent)
+    ? "gpt6_astra_max"
+    : canonical;
 }
 
+/**
+ * Nested headless, team, worker, and delegator launches always select an
+ * explicit role profile rather than inheriting the global Codex config. A
+ * custom profile that resolves to ultra is also downgraded to max.
+ */
 export function resolveNestedCodexAgentProfile(
   agent,
-  { profileOverride = "auto", globalProfile = "auto", retryProfile = null, codexHome } = {},
+  {
+    profileOverride = "auto",
+    globalProfile = "auto",
+    retryProfile = null,
+    codexHome,
+  } = {},
 ) {
   const explicitProfile = String(profileOverride || "auto").trim();
-  const globalOverride = String(globalProfile || "auto").trim();
-  const effectiveOverride = explicitProfile !== "auto" ? explicitProfile : NESTED_GLOBAL_PROFILE_OVERRIDES.has(globalOverride) ? globalOverride : "auto";
+  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 =
+    explicitProfile !== "auto"
+      ? explicitProfile
+      : NESTED_GLOBAL_PROFILE_OVERRIDES.has(globalOverride)
+        ? globalOverride
+        : "auto";
   const fallback = resolveCodexAgentProfile(agent);
-  const candidate = resolveCodexAgentProfile(agent, { profileOverride: effectiveOverride, retryProfile, nested: true, allowCustom: true });
+  const candidate = resolveCodexAgentProfile(agent, {
+    profileOverride: effectiveOverride,
+    retryProfile,
+    nested: true,
+    allowCustom: true,
+  });
   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/cli-codex.mjs

@@ -18,6 +18,8 @@ import {
   resolveNestedCodexAgentProfile,
 } from "./agent-route-policy.mjs";
 
+// Compatibility re-exports for launchers which historically imported these
+// helpers from this adapter. The policy module owns the semantics.
 export { resolveCodexAgentProfile, resolveNestedCodexAgentProfile };
 
 export function plan({

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/codex-recovery.sh

@@ -8,9 +8,16 @@
 # 4차 FALLBACK_FAILED → 모두 실패 시 marker + stderr_log 경로 출력
 
 recover_codex_stdout() {
+  # 복구 진입 여부 플래그(전역, local 아님) — 아우터 no-op 가드가 읽는다.
+  # 0 = 진짜 stdout 존재(복구 미진입), 1 = stdout 이 애초에 비어 복구 진입함.
+  CODEX_STDOUT_WAS_RECOVERED=0
   if [[ -s "$STDOUT_LOG" || ! -s "$STDERR_LOG" ]]; then
     return 0
   fi
+  # 여기 도달 = stdout 이 애초에 비어있었다. 아래에서 STDOUT_LOG 에 채워지는 내용은
+  # 전부 stderr 에서 복구된 것이지 워커의 진짜 산출물이 아니다. 이 플래그로 아우터
+  # 가드가 "복구된 stderr 노이즈"를 성공 출력으로 오인하지 않게 한다(#result-verification).
+  CODEX_STDOUT_WAS_RECOVERED=1
 
   # 1차: codex marker
   sed 's/\r$//' "$STDERR_LOG" \
@@ -48,3 +55,15 @@ recover_codex_stdout() {
     echo "[tfx-route] 경고: codex stdout 비어있음, stderr 복구도 실패. 위 stderr_log 경로에서 raw codex 출력 확인 가능." >&2
   fi
 }
+
+# ── MCP transport 채널 사망 판정 ──
+# Codex MCP transport 채널이 실행 중 죽으면 codex exec 가 exit 0 + 빈 stdout 으로
+# 끝나는 변형이 있다(래퍼 부재로 인한 pre-flight CODEX_MCP_TRANSPORT_EXIT_CODE=70
+# 과 구분됨 — 이건 런타임 채널 사망). stderr 의 하드 크래시 서명으로 이 사망을
+# 검출한다. 아우터 가드가 exit 0 이어도 결과를 실패로 승격하는 근거로 쓴다.
+# 인자: [stderr_log] (미지정 시 $STDERR_LOG). 반환: 0=크래시 서명 있음, 1=없음.
+codex_stdout_transport_crashed() {
+  local stderr_log="${1:-${STDERR_LOG:-}}"
+  [[ -n "$stderr_log" && -f "$stderr_log" ]] || return 1
+  grep -qE 'Transport channel closed|rmcp::transport worker quit with fatal' "$stderr_log" 2>/dev/null
+}

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,
+};

package/scripts/lib/keyword-rules.mjs

@@ -69,6 +69,16 @@ function normalizeRule(rule) {
         .map((s) => s.trim())
     : [];
 
+  // platform: process.platform 화이트리스트 (빈 배열 = 전 플랫폼). Windows 전용
+  // 스킬(tfx-wt 등)이 macOS/Linux 프롬프트에 오탐하는 것을 막는다. 배열이 아닌
+  // 값은 규칙 자체를 무효로 본다.
+  if (rule.platform != null && !Array.isArray(rule.platform)) return null;
+  const platform = Array.isArray(rule.platform)
+    ? rule.platform
+        .filter((s) => typeof s === "string" && s.trim())
+        .map((s) => s.trim())
+    : [];
+
   return {
     id: rule.id.trim(),
     patterns,
@@ -81,6 +91,7 @@ function normalizeRule(rule) {
     state,
     mcp_route: mcpRoute,
     repo_scope: repoScope,
+    platform,
     explicit: rule.explicit === true,
   };
 }
@@ -160,6 +171,7 @@ export function matchRules(compiledRules, cleanText) {
       state: rule.state || null,
       mcp_route: rule.mcp_route || null,
       repo_scope: rule.repo_scope || [],
+      platform: rule.platform || [],
       explicit: rule.explicit === true,
     });
   }