@triflux/core 10.50.2 → 10.51.0

package/scripts/lib/claudemd-scanner.mjs

@@ -1,114 +1,6 @@
-import { existsSync, readFileSync, writeFileSync } from "node:fs";
+import { existsSync } from "node:fs";
 import { homedir } from "node:os";
-import { dirname, join, resolve } from "node:path";
-import { fileURLToPath } from "node:url";
-
-export const TFX_START = "<!-- TFX:START -->";
-export const TFX_END = "<!-- TFX:END -->";
-export const OMC_END = "<!-- OMC:END -->";
-const TFX_VERSION_RE = /<!-- TFX:VERSION:([\d.]+) -->/u;
-
-const LEGACY_PATTERNS = [
-  /<user_cli_routing>/u,
-  /Codex Pro 무료 기간/u,
-  /codex exec --dangerously-bypass.*skip-git-repo-check/u,
-  /OMC 에이전트 → CLI 매핑/u,
-  /Spark 가드레일/u,
-];
-
-const DEFAULT_TFX_TEMPLATE = [
-  "### triflux CLI routing (managed)",
-  "- 이 블록은 triflux setup에서 자동으로 관리됩니다.",
-  "- 직접 수정이 필요하면 블록 바깥에 사용자 섹션을 추가하세요.",
-].join("\n");
-
-const SCRIPT_DIR = dirname(fileURLToPath(import.meta.url));
-const DEFAULT_TEMPLATE_PATH = join(
-  SCRIPT_DIR,
-  "..",
-  "templates",
-  "claudemd-tfx-section.md",
-);
-
-function resolveVersion(version) {
-  if (version) return version;
-  try {
-    const pkgPath = join(SCRIPT_DIR, "..", "..", "package.json");
-    const pkg = JSON.parse(readFileSync(pkgPath, "utf8"));
-    return pkg.version || "0.0.0";
-  } catch {
-    return "0.0.0";
-  }
-}
-
-function resolveTemplate(template, templatePath = DEFAULT_TEMPLATE_PATH) {
-  if (typeof template === "string" && template.trim()) {
-    return template.trim();
-  }
-  if (existsSync(templatePath)) {
-    const raw = readFileSync(templatePath, "utf8").trim();
-    if (raw) return raw;
-  }
-  return DEFAULT_TFX_TEMPLATE;
-}
-
-function findManagedSection(rawText) {
-  const raw = String(rawText || "");
-  const startIdx = raw.indexOf(TFX_START);
-  const endMarkerIdx = raw.indexOf(TFX_END);
-  if (startIdx === -1 || endMarkerIdx === -1 || endMarkerIdx <= startIdx) {
-    return {
-      found: false,
-      content: null,
-      version: null,
-      startIdx: -1,
-      endIdx: -1,
-    };
-  }
-
-  const endIdx = endMarkerIdx + TFX_END.length;
-  const content = raw.slice(startIdx, endIdx);
-  const versionMatch = content.match(TFX_VERSION_RE);
-
-  return {
-    found: true,
-    content,
-    version: versionMatch ? versionMatch[1] : null,
-    startIdx,
-    endIdx,
-  };
-}
-
-function detectLegacyRange(rawText) {
-  const raw = String(rawText || "");
-  const matches = LEGACY_PATTERNS.some((pattern) => pattern.test(raw));
-  if (!matches) {
-    return { found: false, startIdx: -1, endIdx: -1 };
-  }
-
-  const startTag = raw.indexOf("<user_cli_routing>");
-  const endTag = raw.indexOf("</user_cli_routing>");
-  if (startTag === -1 || endTag === -1 || endTag <= startTag) {
-    return { found: true, startIdx: -1, endIdx: -1 };
-  }
-
-  let removeStart = startTag;
-  const userOverridesComment = "<!-- USER OVERRIDES";
-  const commentIdx = raw.lastIndexOf(userOverridesComment, startTag);
-  if (commentIdx !== -1 && startTag - commentIdx < 200) {
-    removeStart = commentIdx;
-  }
-
-  return {
-    found: true,
-    startIdx: removeStart,
-    endIdx: endTag + "</user_cli_routing>".length,
-  };
-}
-
-function normalizeSpacing(text) {
-  return String(text || "").replace(/\n{3,}/gu, "\n\n");
-}
+import { join, resolve } from "node:path";
 
 export function findAllClaudeMdPaths(options = {}) {
   const cwd = options.cwd ? resolve(options.cwd) : process.cwd();
@@ -132,92 +24,3 @@ export function findAllClaudeMdPaths(options = {}) {
   }
   return paths;
 }
-
-export function writeSection(filePath, options = {}) {
-  const absolutePath = resolve(filePath);
-  const version = resolveVersion(options.version);
-  const template = resolveTemplate(options.template, options.templatePath);
-  const block = [
-    TFX_START,
-    `<!-- TFX:VERSION:${version} -->`,
-    template,
-    TFX_END,
-  ].join("\n");
-
-  if (!existsSync(absolutePath)) {
-    writeFileSync(absolutePath, `${block}\n`, "utf8");
-    return { action: "created", version, path: absolutePath };
-  }
-
-  const raw = readFileSync(absolutePath, "utf8");
-  const existing = findManagedSection(raw);
-
-  if (existing.found) {
-    const nextContent = `${raw.slice(0, existing.startIdx)}${block}${raw.slice(existing.endIdx)}`;
-    writeFileSync(absolutePath, nextContent, "utf8");
-    return {
-      action: "updated",
-      oldVersion: existing.version,
-      version,
-      path: absolutePath,
-    };
-  }
-
-  const omcEndIdx = raw.indexOf(OMC_END);
-  if (omcEndIdx !== -1) {
-    const insertAt = omcEndIdx + OMC_END.length;
-    const before = raw.slice(0, insertAt);
-    const after = raw.slice(insertAt);
-    const nextContent = `${before}\n${block}${after}`;
-    writeFileSync(absolutePath, nextContent, "utf8");
-    return { action: "inserted_after_omc", version, path: absolutePath };
-  }
-
-  const separator = raw.endsWith("\n") ? "" : "\n";
-  writeFileSync(absolutePath, `${raw}${separator}${block}\n`, "utf8");
-  return { action: "appended", version, path: absolutePath };
-}
-
-export function migrateClaudeMd(filePath, options = {}) {
-  const absolutePath = resolve(filePath);
-  if (!existsSync(absolutePath)) {
-    return { action: "no_file", removed: [], path: absolutePath };
-  }
-
-  const raw = readFileSync(absolutePath, "utf8");
-  const existing = findManagedSection(raw);
-  const legacy = detectLegacyRange(raw);
-
-  if (existing.found && !legacy.found) {
-    return {
-      action: "already_managed",
-      removed: [],
-      version: existing.version,
-      path: absolutePath,
-    };
-  }
-
-  const removed = [];
-  let nextContent = raw;
-
-  if (legacy.found && legacy.startIdx !== -1 && legacy.endIdx !== -1) {
-    nextContent = `${nextContent.slice(0, legacy.startIdx)}${nextContent.slice(legacy.endIdx)}`;
-    removed.push("<user_cli_routing> block");
-  }
-
-  const existingAfterLegacy = findManagedSection(nextContent);
-  if (existingAfterLegacy.found) {
-    nextContent = `${nextContent.slice(0, existingAfterLegacy.startIdx)}${nextContent.slice(existingAfterLegacy.endIdx)}`;
-    removed.push("old TFX block");
-  }
-
-  writeFileSync(absolutePath, normalizeSpacing(nextContent), "utf8");
-  const writeResult = writeSection(absolutePath, options);
-
-  return {
-    action: "migrated",
-    removed,
-    version: writeResult.version,
-    path: absolutePath,
-  };
-}

package/scripts/lib/cli-claude.mjs

@@ -3,8 +3,6 @@
 // 책임: Claude 는 외부 CLI 가 아닌 Claude Code Agent 도구로 dispatch 된다. plan() 은
 // command=null 을 반환하고 호출자가 Agent() 로 라우팅하도록 신호한다.
 //
-// 출처: scripts/tfx-route.sh route_agent() L1062-L1063 (explore|claude),
-//        L1196-L1203 (TFX_CLI_MODE=gemini fallback), TFX_VERIFIER_OVERRIDE=claude.
 // timeoutSec은 lane 예상 소요 시간(advisory)이다. hard ceiling 집행은 Bash route가 소유한다.
 
 export const id = "claude";

package/scripts/lib/context.mjs

@@ -5,19 +5,13 @@
  * 하나의 요청에서 발생한 모든 로그를 추적할 수 있다.
  *
  * 사용법:
- *   import { getLogger, getCorrelationId, withRequestContext } from './lib/context.mjs';
+ *   import { getCorrelationId, withRequestContext } from './lib/context.mjs';
  *
  *   // 미들웨어에서 컨텍스트 생성
  *   withRequestContext({ method: 'POST', path: '/bridge/result' }, () => {
- *     const log = getLogger();
- *     log.info({ agentId }, 'bridge.result_received');
+ *     const correlationId = getCorrelationId();
  *   });
  *
- *   // 내부 함수에서 자동 상관 ID
- *   function processResult() {
- *     const log = getLogger();
- *     log.info('result.processed'); // correlationId 자동 포함
- *   }
  */
 import { AsyncLocalStorage } from "node:async_hooks";
 import { randomUUID } from "node:crypto";
@@ -25,17 +19,7 @@ import { randomUUID } from "node:crypto";
 import { logger } from "./logger.mjs";
 
 /** @type {AsyncLocalStorage<{logger: import('pino').Logger, correlationId: string}>} */
-export const asyncLocalStorage = new AsyncLocalStorage();
-
-/**
- * 현재 요청 컨텍스트의 로거를 반환한다.
- * 요청 컨텍스트 밖에서 호출하면 기본 로거를 반환한다.
- *
- * @returns {import('pino').Logger}
- */
-export function getLogger() {
-  return asyncLocalStorage.getStore()?.logger || logger;
-}
+const asyncLocalStorage = new AsyncLocalStorage();
 
 /**
  * 현재 요청의 상관 ID를 반환한다.

package/scripts/lib/env-probe.mjs

@@ -1,25 +1,15 @@
-import { execSync, spawn } from "node:child_process";
+import { execSync } from "node:child_process";
 import { createHash } from "node:crypto";
 import { existsSync, readFileSync } from "node:fs";
 import { homedir } from "node:os";
-import { dirname, join } from "node:path";
-import { fileURLToPath } from "node:url";
+import { join } from "node:path";
 import { resolveHubPortForContext } from "../../hub/hub-lifecycle.mjs";
 import { whichCommand, whichCommandAsync } from "../../hub/platform.mjs";
 
 const HUB_DEFAULT_PORT = 27888;
-const DEFAULT_STATUS_URL = "http://127.0.0.1:27888/status";
-const _sab = new Int32Array(new SharedArrayBuffer(4));
 const CLI_PROBE_CACHE = new Map();
 const CLI_PROBE_PROMISES = new Map();
 
-const __filename = fileURLToPath(import.meta.url);
-const DEFAULT_PKG_ROOT = join(dirname(__filename), "..", "..");
-
-function sleepSync(ms) {
-  Atomics.wait(_sab, 0, 0, ms);
-}
-
 function fetchHubStatus({
   execSyncFn = execSync,
   statusUrl = resolveDefaultStatusUrl(),
@@ -38,10 +28,7 @@ function fetchHubStatus({
   };
 }
 
-export function resolveDefaultStatusUrl(
-  env = process.env,
-  cwd = process.cwd(),
-) {
+function resolveDefaultStatusUrl(env = process.env, cwd = process.cwd()) {
   const port = resolveHubPortForContext({
     env,
     cwd,
@@ -125,7 +112,7 @@ async function resolveCliProbe(name, options = {}) {
   return toCliResult(path);
 }
 
-export async function checkCli(name, options = {}) {
+async function checkCli(name, options = {}) {
   const cliName = normalizeCliName(name);
   if (!cliName) return { ok: false };
 
@@ -168,11 +155,6 @@ export async function probeClis(names, options = {}) {
   return mapCliResults(cliNames, results);
 }
 
-export function resetCliProbeCache() {
-  CLI_PROBE_CACHE.clear();
-  CLI_PROBE_PROMISES.clear();
-}
-
 export function detectCodexAuthState({
   homeDir = homedir(),
   existsSyncFn = existsSync,
@@ -241,16 +223,9 @@ export function detectCodexPlan(options = {}) {
 export function checkHub({
   env = process.env,
   cwd = process.cwd(),
-  pkgRoot = DEFAULT_PKG_ROOT,
   statusUrl = resolveDefaultStatusUrl(env, cwd),
-  restart = true,
   requestTimeoutMs = 3000,
-  pollAttempts = 8,
-  pollIntervalMs = 500,
   execSyncFn = execSync,
-  spawnFn = spawn,
-  existsSyncFn = existsSync,
-  sleepSyncFn = sleepSync,
 } = {}) {
   const guardedStatusUrl = resolveStatusUrlForContext({ statusUrl, env, cwd });
   try {
@@ -259,41 +234,7 @@ export function checkHub({
       statusUrl: guardedStatusUrl,
       timeout: requestTimeoutMs,
     });
-  } catch {}
-
-  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" };
-
-  try {
-    const child = spawnFn(process.execPath, [serverPath], {
-      env: { ...env, TFX_HUB_PORT: String(new URL(guardedStatusUrl).port) },
-      detached: true,
-      stdio: "ignore",
-      windowsHide: true,
-    });
-    child.unref();
   } catch {
-    return { ok: false, state: "unreachable", restart: "spawn_failed" };
+    return { ok: false, state: "unreachable", restart: "disabled" };
   }
-
-  for (let i = 0; i < pollAttempts; i++) {
-    sleepSyncFn(pollIntervalMs);
-    try {
-      const status = fetchHubStatus({
-        execSyncFn,
-        statusUrl: guardedStatusUrl,
-        timeout: Math.min(requestTimeoutMs, 1000),
-      });
-      if (status.state === "healthy") {
-        return { ...status, restarted: true };
-      }
-    } catch {}
-  }
-
-  return { ok: false, state: "unreachable", restart: "timeout" };
 }
-
-export { DEFAULT_PKG_ROOT, DEFAULT_STATUS_URL };

package/scripts/lib/gemini-profiles.mjs

@@ -30,36 +30,10 @@ const DEFAULT_GEMINI_PROFILES = {
   },
 };
 
-// 1회 마이그레이션 테이블: 옛 ID 형식 모델값 → agy display name.
-// null = 카탈로그에서 빠진 모델(2.5 계열, 3 Flash) → 해당 프로필 제거 대상.
-const LEGACY_MODEL_MIGRATION = {
-  "gemini-3.1-pro-preview": "Gemini 3.1 Pro (High)",
-  "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,
-};
-// 과거 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)와
-// 실행 모드와 cli-agy가 이 표를 공유한다.
+// 실행 모드(execution-mode)가 이 표를 읽는다.
 //   High   : 판단이 결과를 좌우하는 역할 (검토, 설계, 디버깅, 분석)
 //   Medium : 생성/작성/실행 (기본값)
 //   Low    : 분류, 요약, 추출, 번역처럼 짧고 기계적인 작업
@@ -182,40 +156,6 @@ function ensureGeminiProfiles({
     )
       cfg.profiles = {};
 
-    // ── 1회 마이그레이션: deprecated 2.5 프로필 prune + 옛 ID 형식 → display name ──
-    // merge-only 로직만으로는 기존 사용자 파일에 남은 stale 프로필/옛 모델 ID 가
-    // 정리되지 않으므로, 신규 default 를 채우기 전에 마이그레이션을 먼저 적용한다.
-    let migrated = false;
-    for (const legacy of LEGACY_PROFILE_NAMES) {
-      if (cfg.profiles[legacy]) {
-        delete cfg.profiles[legacy];
-        migrated = true;
-      }
-    }
-    for (const [pname, pval] of Object.entries(cfg.profiles)) {
-      const mid = typeof pval === "string" ? pval : pval?.model;
-      if (mid && Object.hasOwn(LEGACY_MODEL_MIGRATION, mid)) {
-        const repl = LEGACY_MODEL_MIGRATION[mid];
-        if (repl === null) {
-          delete cfg.profiles[pname];
-        } else if (typeof pval === "string") {
-          cfg.profiles[pname] = repl;
-        } else {
-          cfg.profiles[pname].model = repl;
-        }
-        migrated = true;
-      }
-    }
-    if (
-      typeof cfg.model === "string" &&
-      (Object.hasOwn(LEGACY_MODEL_MIGRATION, cfg.model) ||
-        LEGACY_DEFAULT_MODELS.has(cfg.model))
-    ) {
-      // 옛 ID 형식/이전 세대 자동 생성 기본값은 새 기본(DEFAULT)으로 정규화한다.
-      cfg.model = DEFAULT_GEMINI_PROFILES.model;
-      migrated = true;
-    }
-
     let added = 0;
     for (const [name, value] of Object.entries(
       DEFAULT_GEMINI_PROFILES.profiles,
@@ -227,12 +167,7 @@ function ensureGeminiProfiles({
     }
     if (!cfg.model) cfg.model = DEFAULT_GEMINI_PROFILES.model;
 
-    if (added > 0 || migrated) {
-      if (migrated) {
-        try {
-          copyFileSync(profilesPath, profilesPath + `.bak.${Date.now()}`);
-        } catch {}
-      }
+    if (added > 0) {
       writeFileSync(profilesPath, JSON.stringify(cfg, null, 2) + "\n", {
         encoding: "utf8",
         mode: 0o600,
@@ -260,8 +195,6 @@ function ensureGeminiProfiles({
 export {
   DEFAULT_GEMINI_PROFILES,
   ensureGeminiProfiles,
-  GEMINI_DEFAULT_PURPOSE_PROFILE,
-  GEMINI_PROFILE_BY_PURPOSE,
   resolveGeminiModel,
   resolveGeminiProfileForPurpose,
 };

package/scripts/lib/machine-profile.mjs

@@ -14,7 +14,7 @@ import { readFileSync } from "node:fs";
 import { homedir } from "node:os";
 import { join, resolve } from "node:path";
 
-export const MACHINE_PROFILE_FILENAME = "machine-profile.env";
+const MACHINE_PROFILE_FILENAME = "machine-profile.env";
 
 export const MACHINE_PROFILE_KEYS = Object.freeze([
   "TFX_MACHINE_PROFILE_VERSION",
@@ -28,9 +28,9 @@ export const MACHINE_PROFILE_KEYS = Object.freeze([
   "TFX_STALL_KILL",
 ]);
 
-export const MACHINE_PROFILE_KEY_SET = new Set(MACHINE_PROFILE_KEYS);
+const MACHINE_PROFILE_KEY_SET = new Set(MACHINE_PROFILE_KEYS);
 
-export const MACHINE_PROFILE_VALUE_RE = /^[A-Za-z0-9_.-]+$/u;
+const MACHINE_PROFILE_VALUE_RE = /^[A-Za-z0-9_.-]+$/u;
 
 // CLI 이름과 disable 키의 대응. 이 두 개가 TFX_DISABLE_* SSOT 의 전부다.
 const CLI_DISABLE_KEYS = Object.freeze({
@@ -248,20 +248,6 @@ export function normalizeCliName(cli) {
   return CLI_ALIASES[key] || null;
 }
 
-/**
- * 세션 문맥 주입용 한 줄. 형식은 고정이며 소비자가 파싱하지 않고 그대로 보여준다.
- *
- * @param {ReturnType<typeof resolveCliPolicy>} policy
- * @returns {string}
- */
-export function formatCliPolicyLine(policy) {
-  const codex = policy?.codexDisabled ? "off" : "on";
-  const antigravity = policy?.antigravityDisabled ? "off" : "on";
-  const codexSource = policy?.source?.codex || "default";
-  const antigravitySource = policy?.source?.antigravity || "default";
-  return `cli-policy: codex=${codex} antigravity=${antigravity} (SSOT: TFX_DISABLE_*; codex<-${codexSource}, antigravity<-${antigravitySource})`;
-}
-
 /**
  * 차단된 CLI 실행 요청에 쓸 오류를 만든다. throw 는 호출자가 한다. 정책상 허용된
  * CLI 이거나 모르는 이름이면 null 을 준다.