@triflux/core 10.43.0 → 10.45.0

package/scripts/lib/cli-codex.mjs

@@ -4,169 +4,23 @@
 // 산출한다. 실제 spawn 은 Phase 1 에서 이관된다 (현재는 tfx-route.sh 가 수행).
 //
 // 진입점: tfx-route.mjs → selectAdapter("codex") → plan({...}).
-// 출처: scripts/tfx-route.sh route_agent() L1001-L1079 case 문 미러.
+// 출처: agent-route-policy.mjs 의 canonical Codex role policy.
 // timeoutSec은 lane 예상 소요 시간(advisory)이다. hard ceiling 집행은 Bash route가 소유한다.
 
 export const id = "codex";
 export const cliType = "codex";
 export const command = "codex";
 
-const AGENT_PROFILES = {
-  executor: {
-    profile: "gpt56_terra_high",
-    timeoutSec: 1080,
-    runMode: "fg",
-    opusOversight: false,
-    mcpHint: "implement",
-  },
-  codex: {
-    profile: "gpt56_terra_high",
-    timeoutSec: 1080,
-    runMode: "fg",
-    opusOversight: false,
-    mcpHint: "implement",
-  },
-  "build-fixer": {
-    profile: "gpt56_luna_low",
-    timeoutSec: 540,
-    runMode: "fg",
-    opusOversight: false,
-    mcpHint: "implement",
-  },
-  cleanup: {
-    profile: "gpt56_terra_med",
-    timeoutSec: 540,
-    runMode: "fg",
-    opusOversight: false,
-    mcpHint: "implement",
-  },
-  deslop: {
-    profile: "gpt56_terra_med",
-    timeoutSec: 540,
-    runMode: "fg",
-    opusOversight: false,
-    mcpHint: "implement",
-  },
-  debugger: {
-    profile: "gpt56_sol_xhigh",
-    timeoutSec: 900,
-    runMode: "bg",
-    opusOversight: false,
-    mcpHint: "implement",
-  },
-  "deep-executor": {
-    profile: "gpt56_sol_xhigh",
-    timeoutSec: 3600,
-    runMode: "bg",
-    opusOversight: true,
-    mcpHint: "implement",
-  },
-  architect: {
-    profile: "gpt56_sol_xhigh",
-    timeoutSec: 3600,
-    runMode: "bg",
-    opusOversight: true,
-    mcpHint: "analyze",
-  },
-  critic: {
-    profile: "gpt56_sol_xhigh",
-    timeoutSec: 3600,
-    runMode: "bg",
-    opusOversight: true,
-    mcpHint: "analyze",
-  },
-  planner: {
-    profile: "gpt56_sol_xhigh",
-    timeoutSec: 3600,
-    runMode: "fg",
-    opusOversight: true,
-    mcpHint: "analyze",
-  },
-  analyst: {
-    profile: "gpt56_sol_xhigh",
-    timeoutSec: 3600,
-    runMode: "fg",
-    opusOversight: true,
-    mcpHint: "analyze",
-  },
-  "code-reviewer": {
-    profile: "gpt56_terra_high",
-    timeoutSec: 1800,
-    runMode: "bg",
-    opusOversight: false,
-    mcpHint: "review",
-    subcommand: "review",
-  },
-  "quality-reviewer": {
-    profile: "gpt56_terra_high",
-    timeoutSec: 1800,
-    runMode: "bg",
-    opusOversight: false,
-    mcpHint: "review",
-    subcommand: "review",
-  },
-  "security-reviewer": {
-    profile: "gpt56_sol_xhigh",
-    timeoutSec: 1800,
-    runMode: "bg",
-    opusOversight: true,
-    mcpHint: "review",
-    subcommand: "review",
-  },
-  scientist: {
-    profile: "gpt56_terra_high",
-    timeoutSec: 1440,
-    runMode: "bg",
-    opusOversight: false,
-    mcpHint: "analyze",
-  },
-  "document-specialist": {
-    profile: "gpt56_terra_high",
-    timeoutSec: 1440,
-    runMode: "bg",
-    opusOversight: false,
-    mcpHint: "analyze",
-  },
-  "scientist-deep": {
-    profile: "gpt56_sol_xhigh",
-    timeoutSec: 3600,
-    runMode: "bg",
-    opusOversight: false,
-    mcpHint: "analyze",
-  },
-  verifier: {
-    profile: "gpt56_terra_high",
-    timeoutSec: 1200,
-    runMode: "fg",
-    opusOversight: false,
-    mcpHint: "review",
-    subcommand: "review",
-  },
-  "test-engineer": {
-    profile: "gpt56_terra_high",
-    timeoutSec: 1200,
-    runMode: "bg",
-    opusOversight: false,
-    mcpHint: "implement",
-  },
-  "qa-tester": {
-    profile: "gpt56_terra_high",
-    timeoutSec: 1200,
-    runMode: "bg",
-    opusOversight: false,
-    mcpHint: "review",
-    subcommand: "review",
-  },
-  spark: {
-    profile: "gpt56_luna_low",
-    timeoutSec: 180,
-    runMode: "fg",
-    opusOversight: false,
-    mcpHint: "implement",
-  },
-};
+import {
+  CODEX_AGENT_POLICY,
+  resolveCodexAgentPolicy,
+  resolveCodexAgentProfile,
+  resolveNestedCodexAgentProfile,
+} from "./agent-route-policy.mjs";
 
-const DEFAULT_PROFILE = AGENT_PROFILES.executor;
+// 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({
   agent,
@@ -174,18 +28,26 @@ export function plan({
   mcpProfile = "auto",
   timeoutSec,
   contextFile,
+  profileOverride = "auto",
+  retryProfile = null,
+  nested = false,
 } = {}) {
   if (!agent) {
     throw new Error("[cli-codex] agent required");
   }
-  const cfg = AGENT_PROFILES[agent] ?? DEFAULT_PROFILE;
+  const cfg = resolveCodexAgentPolicy(agent);
+  const profile = resolveCodexAgentProfile(agent, {
+    profileOverride,
+    retryProfile,
+    nested,
+  });
   const effectiveTimeoutSec =
     Number.isFinite(timeoutSec) && timeoutSec > 0 ? timeoutSec : cfg.timeoutSec;
   return {
     command,
     subcommand: cfg.subcommand ?? "exec",
-    profile: cfg.profile,
-    effort: cfg.profile,
+    profile,
+    effort: profile,
     timeoutMs: effectiveTimeoutSec * 1000,
     runMode: cfg.runMode,
     opusOversight: cfg.opusOversight,
@@ -196,5 +58,5 @@ export function plan({
 }
 
 export function describe() {
-  return { id, cliType, command, agents: Object.keys(AGENT_PROFILES) };
+  return { id, cliType, command, agents: Object.keys(CODEX_AGENT_POLICY) };
 }

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

@@ -9,6 +9,8 @@ import { homedir } from "node:os";
 import { dirname, join } from "node:path";
 
 const EFFORT_BY_SUFFIX = {
+  ultra: "ultra",
+  max: "max",
   xhigh: "xhigh",
   high: "high",
   med: "medium",
@@ -16,6 +18,26 @@ const EFFORT_BY_SUFFIX = {
   low: "low",
 };
 
+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" },
+  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(
@@ -49,23 +71,45 @@ function readProfileScalar(raw, key) {
  * @param {{ codexHome?: string }} [opts]
  * @returns {string[]} e.g. ['model="gpt-5.6-terra"', 'model_reasoning_effort="high"']
  */
-export function codexProfileConfigOverrides(profileName, opts = {}) {
-  if (typeof profileName !== "string" || !profileName) return [];
+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 = /_(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 = {}) {
+  const normalizedProfileName = normalizeCodexProfileName(profileName);
+  let { model, effort } = resolveCodexProfileConfigValues(
+    normalizedProfileName,
+    opts,
+  );
+  if (opts.enforceCanonicalProfile === true) {
+    const canonical = CANONICAL_PROFILE_VALUES[normalizedProfileName];
+    if (canonical) ({ model, effort } = canonical);
+  }
+  if (opts.disallowUltra === true && effort?.toLowerCase() === "ultra") {
+    model = "gpt-6-astra";
+    effort = "max";
+  }
   const overrides = [];
   if (model) overrides.push(`model="${model}"`);
   if (effort) overrides.push(`model_reasoning_effort="${effort}"`);

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

@@ -26,6 +26,7 @@ function normalizeState(state) {
 
 function normalizeRule(rule) {
   if (!rule || typeof rule !== "object") return null;
+  if (rule.disabled === true) return null;
   if (typeof rule.id !== "string" || !rule.id.trim()) return null;
   if (!Array.isArray(rule.patterns) || rule.patterns.length === 0) return null;
   if (typeof rule.priority !== "number" || !Number.isFinite(rule.priority))
@@ -61,6 +62,23 @@ function normalizeRule(rule) {
   const state = normalizeState(rule.state);
   if (rule.state != null && state == null) return null;
 
+  // repo_scope: path segment 화이트리스트 (빈 배열 = 전역). explicit: 종결 라우팅 마커.
+  const repoScope = Array.isArray(rule.repo_scope)
+    ? rule.repo_scope
+        .filter((s) => typeof s === "string" && s.trim())
+        .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,
@@ -72,6 +90,9 @@ function normalizeRule(rule) {
     exclusive: rule.exclusive === true,
     state,
     mcp_route: mcpRoute,
+    repo_scope: repoScope,
+    platform,
+    explicit: rule.explicit === true,
   };
 }
 
@@ -149,6 +170,9 @@ export function matchRules(compiledRules, cleanText) {
       exclusive: rule.exclusive === true,
       state: rule.state || null,
       mcp_route: rule.mcp_route || null,
+      repo_scope: rule.repo_scope || [],
+      platform: rule.platform || [],
+      explicit: rule.explicit === true,
     });
   }
 

package/scripts/lib/logger.mjs

@@ -31,54 +31,71 @@ import pino from "pino";
 
 const isDev = process.env.NODE_ENV !== "production";
 
-export const logger = pino({
-  level: process.env.LOG_LEVEL || (isDev ? "debug" : "info"),
+// 로그는 항상 stderr(fd 2)로 보낸다.
+//
+// Claude Code 훅은 stdout 을 훅의 JSON 페이로드로 파싱한다. 로그가 stdout 으로
+// 나가면 페이로드와 한 스트림에 섞여, 훅이 돌려준 hookSpecificOutput 이 JSON 으로
+// 해석되지 않고 그냥 본문 텍스트가 된다. Claude Code 2.1.257 부터는 stdout 이
+// "{" 로 시작하는데 유효한 JSON 이 아니면 훅 오류로 보고하므로, 로그가 먼저 나가느냐
+// 페이로드가 먼저 나가느냐에 따라 훅 전체가 실패로 뒤집힌다.
+//
+// stderr 로 보내면 Claude Code 가 verbose/transcript 에서 그대로 보여주고 stdout 은
+// 페이로드만 남는다. CLI 관례상으로도 구조화 로그는 stderr 가 맞다.
+const LOG_FD = 2;
 
-  // 모든 로그에 포함되는 기본 필드
-  base: {
-    service: process.env.SERVICE_NAME || "triflux",
-    env: process.env.NODE_ENV || "development",
-  },
+export const logger = pino(
+  {
+    level: process.env.LOG_LEVEL || (isDev ? "debug" : "info"),
 
-  // 레벨을 대문자로 출력 (AI 파싱 용이)
-  formatters: {
-    level: (label) => ({ level: label.toUpperCase() }),
-  },
+    // 모든 로그에 포함되는 기본 필드
+    base: {
+      service: process.env.SERVICE_NAME || "triflux",
+      env: process.env.NODE_ENV || "development",
+    },
 
-  // ISO 8601 타임스탬프
-  timestamp: pino.stdTimeFunctions.isoTime,
+    // 레벨을 대문자로 출력 (AI 파싱 용이)
+    formatters: {
+      level: (label) => ({ level: label.toUpperCase() }),
+    },
 
-  // 민감정보 자동 필터링
-  redact: {
-    paths: [
-      "password",
-      "token",
-      "apiKey",
-      "secret",
-      "authorization",
-      "*.password",
-      "*.token",
-      "*.apiKey",
-      "*.secret",
-      "req.headers.authorization",
-      "req.headers.cookie",
-      "hubToken",
-    ],
-    remove: true,
-  },
+    // ISO 8601 타임스탬프
+    timestamp: pino.stdTimeFunctions.isoTime,
 
-  // 개발 환경: 컬러 콘솔 출력
-  transport: isDev
-    ? {
-        target: "pino-pretty",
-        options: {
-          colorize: true,
-          translateTime: "yyyy-mm-dd HH:MM:ss",
-          ignore: "pid,hostname",
-        },
-      }
-    : undefined,
-});
+    // 민감정보 자동 필터링
+    redact: {
+      paths: [
+        "password",
+        "token",
+        "apiKey",
+        "secret",
+        "authorization",
+        "*.password",
+        "*.token",
+        "*.apiKey",
+        "*.secret",
+        "req.headers.authorization",
+        "req.headers.cookie",
+        "hubToken",
+      ],
+      remove: true,
+    },
+
+    // 개발 환경: 컬러 콘솔 출력 (stderr)
+    transport: isDev
+      ? {
+          target: "pino-pretty",
+          options: {
+            colorize: true,
+            translateTime: "yyyy-mm-dd HH:MM:ss",
+            ignore: "pid,hostname",
+            destination: LOG_FD,
+          },
+        }
+      : undefined,
+  },
+  // 운영 환경(transport 미사용)에서도 stdout 이 아니라 stderr 로 쓴다.
+  isDev ? undefined : pino.destination({ dest: LOG_FD, sync: false }),
+);
 
 /**
  * 모듈별 Child Logger 생성.