triflux 10.4.0 → 10.7.0

package/scripts/lib/claudemd-scanner.mjs

@@ -23,7 +23,12 @@ const DEFAULT_TFX_TEMPLATE = [
 ].join("\n");
 
 const SCRIPT_DIR = dirname(fileURLToPath(import.meta.url));
-const DEFAULT_TEMPLATE_PATH = join(SCRIPT_DIR, "..", "templates", "claudemd-tfx-section.md");
+const DEFAULT_TEMPLATE_PATH = join(
+  SCRIPT_DIR,
+  "..",
+  "templates",
+  "claudemd-tfx-section.md",
+);
 
 function resolveVersion(version) {
   if (version) return version;

package/scripts/lib/context.mjs

@@ -19,10 +19,10 @@
  *     log.info('result.processed'); // correlationId 자동 포함
  *   }
  */
-import { AsyncLocalStorage } from 'node:async_hooks';
-import { randomUUID } from 'node:crypto';
+import { AsyncLocalStorage } from "node:async_hooks";
+import { randomUUID } from "node:crypto";
 
-import { logger } from './logger.mjs';
+import { logger } from "./logger.mjs";
 
 /** @type {AsyncLocalStorage<{logger: import('pino').Logger, correlationId: string}>} */
 export const asyncLocalStorage = new AsyncLocalStorage();

package/scripts/lib/cross-review-utils.mjs

@@ -28,8 +28,10 @@ export function nowSec() {
 }
 
 export function resolveBaseDir(payload) {
-  if (typeof payload?.cwd === "string" && payload.cwd.trim()) return payload.cwd;
-  if (typeof payload?.directory === "string" && payload.directory.trim()) return payload.directory;
+  if (typeof payload?.cwd === "string" && payload.cwd.trim())
+    return payload.cwd;
+  if (typeof payload?.directory === "string" && payload.directory.trim())
+    return payload.directory;
   return process.cwd();
 }
 
@@ -38,7 +40,8 @@ export function shouldTrackPath(filePath) {
 
   const lower = filePath.toLowerCase();
   if (lower.startsWith(".omc/") || lower.startsWith(".claude/")) return false;
-  if (lower === "package-lock.json" || lower.endsWith("/package-lock.json")) return false;
+  if (lower === "package-lock.json" || lower.endsWith("/package-lock.json"))
+    return false;
   if (/\.(md|lock|yml|yaml)$/i.test(lower)) return false;
   return true;
 }

package/scripts/lib/env-probe.mjs

@@ -1,9 +1,9 @@
+import { execSync, spawn } from "node:child_process";
+import { createHash } from "node:crypto";
 import { existsSync, readFileSync } from "node:fs";
-import { join, dirname } from "node:path";
 import { homedir } from "node:os";
-import { execSync, spawn } from "node:child_process";
+import { dirname, join } from "node:path";
 import { fileURLToPath } from "node:url";
-import { createHash } from "node:crypto";
 import { whichCommand, whichCommandAsync } from "../../hub/platform.mjs";
 
 const DEFAULT_STATUS_URL = "http://127.0.0.1:27888/status";
@@ -73,10 +73,13 @@ function normalizeCliNames(names) {
 }
 
 function mapCliResults(names, results) {
-  return names.reduce((acc, name, index) => ({
-    ...acc,
-    [name]: results[index],
-  }), {});
+  return names.reduce(
+    (acc, name, index) => ({
+      ...acc,
+      [name]: results[index],
+    }),
+    {},
+  );
 }
 
 async function resolveCliProbe(name, options = {}) {
@@ -115,13 +118,18 @@ export function checkCliSync(name, options = {}) {
   const cached = readCachedCliResult(cliName);
   if (cached) return cached;
 
-  const path = (options.whichCommandFn || whichCommand)(cliName, buildCliProbeOptions(options));
+  const path = (options.whichCommandFn || whichCommand)(
+    cliName,
+    buildCliProbeOptions(options),
+  );
   return storeCliResult(cliName, toCliResult(path));
 }
 
 export async function probeClis(names, options = {}) {
   const cliNames = normalizeCliNames(names);
-  const results = await Promise.all(cliNames.map((name) => checkCli(name, options)));
+  const results = await Promise.all(
+    cliNames.map((name) => checkCli(name, options)),
+  );
   return mapCliResults(cliNames, results);
 }
 
@@ -137,15 +145,18 @@ export function detectCodexAuthState({
 } = {}) {
   try {
     const authPath = join(homeDir, ".codex", "auth.json");
-    if (!existsSyncFn(authPath)) return { plan: "unknown", source: "no_auth", fingerprint: "no_auth" };
+    if (!existsSyncFn(authPath))
+      return { plan: "unknown", source: "no_auth", fingerprint: "no_auth" };
 
     const auth = JSON.parse(readFileSyncFn(authPath, "utf8"));
     if (auth.auth_mode !== "chatgpt") {
       const fingerprint = createHash("sha256")
-        .update(JSON.stringify({
-          auth_mode: auth.auth_mode || "api_key",
-          has_api_key: Boolean(auth.api_key || auth.apiKey),
-        }))
+        .update(
+          JSON.stringify({
+            auth_mode: auth.auth_mode || "api_key",
+            has_api_key: Boolean(auth.api_key || auth.apiKey),
+          }),
+        )
         .digest("hex");
       return { plan: "api", source: "api_key", fingerprint };
     }
@@ -156,20 +167,30 @@ export function detectCodexAuthState({
         plan: "unknown",
         source: "no_token",
         fingerprint: createHash("sha256")
-          .update(JSON.stringify({ auth_mode: auth.auth_mode || "chatgpt", token: null }))
+          .update(
+            JSON.stringify({
+              auth_mode: auth.auth_mode || "chatgpt",
+              token: null,
+            }),
+          )
           .digest("hex"),
       };
     }
 
-    const payload = JSON.parse(Buffer.from(token.split(".")[1], "base64url").toString());
-    const plan = payload?.["https://api.openai.com/auth"]?.chatgpt_plan_type || "unknown";
+    const payload = JSON.parse(
+      Buffer.from(token.split(".")[1], "base64url").toString(),
+    );
+    const plan =
+      payload?.["https://api.openai.com/auth"]?.chatgpt_plan_type || "unknown";
     const fingerprint = createHash("sha256")
-      .update(JSON.stringify({
-        auth_mode: auth.auth_mode || "chatgpt",
-        plan,
-        sub: payload?.sub || null,
-        exp: payload?.exp || null,
-      }))
+      .update(
+        JSON.stringify({
+          auth_mode: auth.auth_mode || "chatgpt",
+          plan,
+          sub: payload?.sub || null,
+          exp: payload?.exp || null,
+        }),
+      )
       .digest("hex");
     return { plan, source: "jwt", fingerprint };
   } catch {
@@ -205,7 +226,8 @@ export function checkHub({
   if (!restart) return { ok: false, state: "unreachable", restart: "disabled" };
 
   const serverPath = join(pkgRoot, "hub", "server.mjs");
-  if (!existsSyncFn(serverPath)) return { ok: false, state: "unreachable", restart: "no_server" };
+  if (!existsSyncFn(serverPath))
+    return { ok: false, state: "unreachable", restart: "no_server" };
 
   try {
     const child = spawnFn(process.execPath, [serverPath], {
@@ -235,7 +257,4 @@ export function checkHub({
   return { ok: false, state: "unreachable", restart: "timeout" };
 }
 
-export {
-  DEFAULT_PKG_ROOT,
-  DEFAULT_STATUS_URL,
-};
+export { DEFAULT_PKG_ROOT, DEFAULT_STATUS_URL };

package/scripts/lib/gemini-profiles.mjs

@@ -1,19 +1,33 @@
-import { copyFileSync, existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import {
+  copyFileSync,
+  existsSync,
+  mkdirSync,
+  readFileSync,
+  writeFileSync,
+} from "node:fs";
 import { homedir } from "node:os";
 import { join } from "node:path";
 
 const DEFAULT_GEMINI_PROFILES = {
   model: "gemini-3.1-pro-preview",
   profiles: {
-    pro31: { model: "gemini-3.1-pro-preview", hint: "3.1 Pro — 플래그십 (1M ctx, 멀티모달)" },
-    flash3: { model: "gemini-3-flash-preview", hint: "3.0 Flash — 빠른 응답, 비용 효율" },
+    pro31: {
+      model: "gemini-3.1-pro-preview",
+      hint: "3.1 Pro — 플래그십 (1M ctx, 멀티모달)",
+    },
+    flash3: {
+      model: "gemini-3-flash-preview",
+      hint: "3.0 Flash — 빠른 응답, 비용 효율",
+    },
     pro25: { model: "gemini-2.5-pro", hint: "2.5 Pro — 안정 (추론 강화)" },
     flash25: { model: "gemini-2.5-flash", hint: "2.5 Flash — 경량 범용" },
     lite25: { model: "gemini-2.5-flash-lite", hint: "2.5 Flash Lite — 최경량" },
   },
 };
 
-const DEFAULT_PROFILE_COUNT = Object.keys(DEFAULT_GEMINI_PROFILES.profiles).length;
+const DEFAULT_PROFILE_COUNT = Object.keys(
+  DEFAULT_GEMINI_PROFILES.profiles,
+).length;
 
 function ensureGeminiProfiles({
   geminiDir = join(homedir(), ".gemini"),
@@ -23,7 +37,11 @@ function ensureGeminiProfiles({
     if (!existsSync(geminiDir)) mkdirSync(geminiDir, { recursive: true });
 
     if (!existsSync(profilesPath)) {
-      writeFileSync(profilesPath, JSON.stringify(DEFAULT_GEMINI_PROFILES, null, 2) + "\n", { encoding: "utf8", mode: 0o600 });
+      writeFileSync(
+        profilesPath,
+        JSON.stringify(DEFAULT_GEMINI_PROFILES, null, 2) + "\n",
+        { encoding: "utf8", mode: 0o600 },
+      );
       return {
         ok: true,
         created: true,
@@ -37,8 +55,14 @@ function ensureGeminiProfiles({
     try {
       cfg = JSON.parse(readFileSync(profilesPath, "utf8"));
     } catch {
-      try { copyFileSync(profilesPath, profilesPath + `.bak.${Date.now()}`); } catch {}
-      writeFileSync(profilesPath, JSON.stringify(DEFAULT_GEMINI_PROFILES, null, 2) + "\n", { encoding: "utf8", mode: 0o600 });
+      try {
+        copyFileSync(profilesPath, profilesPath + `.bak.${Date.now()}`);
+      } catch {}
+      writeFileSync(
+        profilesPath,
+        JSON.stringify(DEFAULT_GEMINI_PROFILES, null, 2) + "\n",
+        { encoding: "utf8", mode: 0o600 },
+      );
       return {
         ok: true,
         created: true,
@@ -49,10 +73,17 @@ function ensureGeminiProfiles({
     }
 
     if (!cfg || typeof cfg !== "object" || Array.isArray(cfg)) cfg = {};
-    if (!cfg.profiles || typeof cfg.profiles !== "object" || Array.isArray(cfg.profiles)) cfg.profiles = {};
+    if (
+      !cfg.profiles ||
+      typeof cfg.profiles !== "object" ||
+      Array.isArray(cfg.profiles)
+    )
+      cfg.profiles = {};
 
     let added = 0;
-    for (const [name, value] of Object.entries(DEFAULT_GEMINI_PROFILES.profiles)) {
+    for (const [name, value] of Object.entries(
+      DEFAULT_GEMINI_PROFILES.profiles,
+    )) {
       if (!cfg.profiles[name]) {
         cfg.profiles[name] = value;
         added++;
@@ -61,7 +92,10 @@ function ensureGeminiProfiles({
     if (!cfg.model) cfg.model = DEFAULT_GEMINI_PROFILES.model;
 
     if (added > 0) {
-      writeFileSync(profilesPath, JSON.stringify(cfg, null, 2) + "\n", { encoding: "utf8", mode: 0o600 });
+      writeFileSync(profilesPath, JSON.stringify(cfg, null, 2) + "\n", {
+        encoding: "utf8",
+        mode: 0o600,
+      });
     }
 
     return {

package/scripts/lib/handoff.mjs

@@ -18,7 +18,9 @@ function runCommand(command, cwd, executor = execSync) {
 }
 
 function parseStatusLines(statusText) {
-  const lines = String(statusText || "").split(/\r?\n/u).filter(Boolean);
+  const lines = String(statusText || "")
+    .split(/\r?\n/u)
+    .filter(Boolean);
   const changedFiles = [];
   const status = [];
 
@@ -28,7 +30,9 @@ function parseStatusLines(statusText) {
 
     const rawStatus = normalized.slice(0, 2).trim() || "??";
     const rawPath = normalized.slice(3).trim();
-    const filePath = rawPath.includes(" -> ") ? rawPath.split(" -> ").at(-1)?.trim() : rawPath;
+    const filePath = rawPath.includes(" -> ")
+      ? rawPath.split(" -> ").at(-1)?.trim()
+      : rawPath;
     if (!filePath) continue;
 
     changedFiles.push(filePath);
@@ -82,22 +86,30 @@ function formatAheadBehind(value) {
 
 export function collectHandoffContext(options = {}) {
   const cwd = resolve(options.cwd || process.cwd());
-  const executor = typeof options.commandRunner === "function" ? options.commandRunner : execSync;
+  const executor =
+    typeof options.commandRunner === "function"
+      ? options.commandRunner
+      : execSync;
   const target = options.target === "local" ? "local" : "remote";
   const decisions = normalizeDecisions(options.decisions, options.decisionFile);
   const generatedAt = options.generatedAt || new Date().toISOString();
   const claudeMdPaths = Array.isArray(options.claudeMdPaths)
     ? options.claudeMdPaths
     : findAllClaudeMdPaths({
-      cwd,
-      homeDir: options.homeDir,
-    });
+        cwd,
+        homeDir: options.homeDir,
+      });
 
   const gitRoot = runCommand("git rev-parse --show-toplevel", cwd, executor);
-  const branch = runCommand("git rev-parse --abbrev-ref HEAD", cwd, executor) || null;
+  const branch =
+    runCommand("git rev-parse --abbrev-ref HEAD", cwd, executor) || null;
   const shortStatus = runCommand("git status --short", cwd, executor);
   const diffStat = runCommand("git diff --stat --no-color", cwd, executor);
-  const upstreamRaw = runCommand("git rev-list --left-right --count @{upstream}...HEAD", cwd, executor);
+  const upstreamRaw = runCommand(
+    "git rev-list --left-right --count @{upstream}...HEAD",
+    cwd,
+    executor,
+  );
   const parsedStatus = parseStatusLines(shortStatus);
 
   return {
@@ -122,15 +134,19 @@ export function buildHandoffPrompt(context) {
   const upstream = safeContext.upstream
     ? `ahead ${safeContext.upstream.ahead}, behind ${safeContext.upstream.behind}`
     : "unknown";
-  const changedFiles = safeContext.changedFiles.length > 0
-    ? safeContext.changedFiles.map((file) => `- ${file}`).join("\n")
-    : "- 변경 파일 없음";
-  const decisions = safeContext.decisions.length > 0
-    ? safeContext.decisions.map((decision) => `- ${decision}`).join("\n")
-    : "- 명시된 결정사항 없음";
-  const claudeMdList = Array.isArray(safeContext.claudeMdPaths) && safeContext.claudeMdPaths.length > 0
-    ? safeContext.claudeMdPaths.map((path) => `- ${path}`).join("\n")
-    : "- 자동 탐지된 CLAUDE.md 없음";
+  const changedFiles =
+    safeContext.changedFiles.length > 0
+      ? safeContext.changedFiles.map((file) => `- ${file}`).join("\n")
+      : "- 변경 파일 없음";
+  const decisions =
+    safeContext.decisions.length > 0
+      ? safeContext.decisions.map((decision) => `- ${decision}`).join("\n")
+      : "- 명시된 결정사항 없음";
+  const claudeMdList =
+    Array.isArray(safeContext.claudeMdPaths) &&
+    safeContext.claudeMdPaths.length > 0
+      ? safeContext.claudeMdPaths.map((path) => `- ${path}`).join("\n")
+      : "- 자동 탐지된 CLAUDE.md 없음";
   const diffStat = safeContext.diffStat || "(diff stat 없음)";
 
   return [

package/scripts/lib/hook-utils.mjs

@@ -1,10 +1,12 @@
 export function nudge(message) {
-  process.stdout.write(JSON.stringify({
-    hookSpecificOutput: {
-      hookEventName: "PreToolUse",
-      additionalContext: message,
-    },
-  }));
+  process.stdout.write(
+    JSON.stringify({
+      hookSpecificOutput: {
+        hookEventName: "PreToolUse",
+        additionalContext: message,
+      },
+    }),
+  );
   process.exit(0);
 }
 

package/scripts/lib/keyword-rules.mjs

@@ -28,21 +28,31 @@ function normalizeRule(rule) {
   if (!rule || typeof rule !== "object") 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)) return null;
+  if (typeof rule.priority !== "number" || !Number.isFinite(rule.priority))
+    return null;
 
   const patterns = rule.patterns.map(normalizePattern).filter(Boolean);
   if (patterns.length === 0) return null;
 
-  const skill = typeof rule.skill === "string" && rule.skill.trim() ? rule.skill.trim() : null;
-  const action = typeof rule.action === "string" && rule.action.trim() ? rule.action.trim() : null;
-  const mcpRoute = typeof rule.mcp_route === "string" && VALID_MCP_ROUTES.has(rule.mcp_route)
-    ? rule.mcp_route
-    : null;
+  const skill =
+    typeof rule.skill === "string" && rule.skill.trim()
+      ? rule.skill.trim()
+      : null;
+  const action =
+    typeof rule.action === "string" && rule.action.trim()
+      ? rule.action.trim()
+      : null;
+  const mcpRoute =
+    typeof rule.mcp_route === "string" && VALID_MCP_ROUTES.has(rule.mcp_route)
+      ? rule.mcp_route
+      : null;
 
   if (!skill && !mcpRoute && !action) return null;
 
   const supersedes = Array.isArray(rule.supersedes)
-    ? rule.supersedes.filter((id) => typeof id === "string" && id.trim()).map((id) => id.trim())
+    ? rule.supersedes
+        .filter((id) => typeof id === "string" && id.trim())
+        .map((id) => id.trim())
     : [];
 
   const state = normalizeState(rule.state);
@@ -57,7 +67,7 @@ function normalizeRule(rule) {
     supersedes,
     exclusive: rule.exclusive === true,
     state,
-    mcp_route: mcpRoute
+    mcp_route: mcpRoute,
   };
 }
 
@@ -81,26 +91,40 @@ export function loadRules(rulesPath) {
 
 // pattern.source / flags를 RegExp로 컴파일
 export function compileRules(rules) {
-  return rules.map((rule) => {
-    try {
-      return { ...rule, compiledPatterns: rule.patterns.map((p) => new RegExp(p.source, p.flags)) };
-    } catch (error) {
-      logRuleError(`정규식 컴파일 실패: ${rule.id}`, error);
-      return null;
-    }
-  }).filter(Boolean);
+  return rules
+    .map((rule) => {
+      try {
+        return {
+          ...rule,
+          compiledPatterns: rule.patterns.map(
+            (p) => new RegExp(p.source, p.flags),
+          ),
+        };
+      } catch (error) {
+        logRuleError(`정규식 컴파일 실패: ${rule.id}`, error);
+        return null;
+      }
+    })
+    .filter(Boolean);
 }
 
 // 입력 텍스트에서 매칭된 규칙 목록 반환
 export function matchRules(compiledRules, cleanText) {
-  if (!Array.isArray(compiledRules) || typeof cleanText !== "string" || !cleanText) {
+  if (
+    !Array.isArray(compiledRules) ||
+    typeof cleanText !== "string" ||
+    !cleanText
+  ) {
     return [];
   }
 
   const matches = [];
 
   for (const rule of compiledRules) {
-    if (!Array.isArray(rule.compiledPatterns) || rule.compiledPatterns.length === 0) {
+    if (
+      !Array.isArray(rule.compiledPatterns) ||
+      rule.compiledPatterns.length === 0
+    ) {
       continue;
     }
 
@@ -119,7 +143,7 @@ export function matchRules(compiledRules, cleanText) {
       supersedes: rule.supersedes || [],
       exclusive: rule.exclusive === true,
       state: rule.state || null,
-      mcp_route: rule.mcp_route || null
+      mcp_route: rule.mcp_route || null,
     });
   }
 

package/scripts/lib/logger.mjs

@@ -27,17 +27,17 @@
  *   error  — 작업 실패 (CLI 실행 실패, MCP 연결 끊김)
  *   fatal  — 프로세스 위협 (DB 연결 불가, 포트 충돌)
  */
-import pino from 'pino';
+import pino from "pino";
 
-const isDev = process.env.NODE_ENV !== 'production';
+const isDev = process.env.NODE_ENV !== "production";
 
 export const logger = pino({
-  level: process.env.LOG_LEVEL || (isDev ? 'debug' : 'info'),
+  level: process.env.LOG_LEVEL || (isDev ? "debug" : "info"),
 
   // 모든 로그에 포함되는 기본 필드
   base: {
-    service: process.env.SERVICE_NAME || 'triflux',
-    env: process.env.NODE_ENV || 'development',
+    service: process.env.SERVICE_NAME || "triflux",
+    env: process.env.NODE_ENV || "development",
   },
 
   // 레벨을 대문자로 출력 (AI 파싱 용이)
@@ -51,18 +51,18 @@ export const logger = pino({
   // 민감정보 자동 필터링
   redact: {
     paths: [
-      'password',
-      'token',
-      'apiKey',
-      'secret',
-      'authorization',
-      '*.password',
-      '*.token',
-      '*.apiKey',
-      '*.secret',
-      'req.headers.authorization',
-      'req.headers.cookie',
-      'hubToken',
+      "password",
+      "token",
+      "apiKey",
+      "secret",
+      "authorization",
+      "*.password",
+      "*.token",
+      "*.apiKey",
+      "*.secret",
+      "req.headers.authorization",
+      "req.headers.cookie",
+      "hubToken",
     ],
     remove: true,
   },
@@ -70,11 +70,11 @@ export const logger = pino({
   // 개발 환경: 컬러 콘솔 출력
   transport: isDev
     ? {
-        target: 'pino-pretty',
+        target: "pino-pretty",
         options: {
           colorize: true,
-          translateTime: 'yyyy-mm-dd HH:MM:ss',
-          ignore: 'pid,hostname',
+          translateTime: "yyyy-mm-dd HH:MM:ss",
+          ignore: "pid,hostname",
         },
       }
     : undefined,
@@ -92,14 +92,14 @@ export function createModuleLogger(module) {
 }
 
 // 정상 종료 시 버퍼 flush 보장
-process.on('uncaughtException', (err) => {
-  logger.fatal({ err }, 'process.uncaught_exception');
+process.on("uncaughtException", (err) => {
+  logger.fatal({ err }, "process.uncaught_exception");
   logger.flush();
   process.exit(1);
 });
 
-process.on('unhandledRejection', (reason) => {
-  logger.fatal({ reason: String(reason) }, 'process.unhandled_rejection');
+process.on("unhandledRejection", (reason) => {
+  logger.fatal({ reason: String(reason) }, "process.unhandled_rejection");
   logger.flush();
   process.exit(1);
 });