triflux 10.3.4 → 10.7.0

package/scripts/cache-warmup.mjs

@@ -1,25 +1,35 @@
 #!/usr/bin/env node
 
+import { execSync } from "node:child_process";
 import {
   existsSync,
   mkdirSync,
-  readFileSync,
   readdirSync,
+  readFileSync,
   statSync,
   writeFileSync,
 } from "node:fs";
-import { execSync } from "node:child_process";
-import { join, basename, dirname } from "node:path";
 import { homedir } from "node:os";
+import { basename, dirname, join } from "node:path";
 import { fileURLToPath } from "node:url";
-
+import {
+  checkCliSync,
+  checkHub,
+  detectCodexAuthState,
+} from "./lib/env-probe.mjs";
+import {
+  MCP_SERVER_DOMAIN_TAGS,
+  SEARCH_SERVER_ORDER,
+} from "./lib/mcp-server-catalog.mjs";
 import { readPreflightCache } from "./preflight-cache.mjs";
-import { checkCliSync, checkHub, detectCodexAuthState } from "./lib/env-probe.mjs";
-import { SEARCH_SERVER_ORDER, MCP_SERVER_DOMAIN_TAGS } from "./lib/mcp-server-catalog.mjs";
 
 export const DEFAULT_CACHE_TTL_MS = 5 * 60 * 1000;
 const WARMUP_METADATA_FILE = ["state", "warmup-metadata.json"];
-const AUTH_SENSITIVE_TARGETS = new Set(["codexSkills", "tierEnvironment", "searchEngines"]);
+const AUTH_SENSITIVE_TARGETS = new Set([
+  "codexSkills",
+  "tierEnvironment",
+  "searchEngines",
+]);
 
 export const CACHE_TARGETS = Object.freeze({
   codexSkills: Object.freeze({
@@ -118,7 +128,7 @@ function isFresh(target, options = {}) {
     const ttlMs = resolveTtlMs(target, options);
     const now = options.now ?? Date.now();
     const stat = statSync(filePath);
-    return ttlMs > 0 && (now - stat.mtimeMs) < ttlMs;
+    return ttlMs > 0 && now - stat.mtimeMs < ttlMs;
   } catch {
     return false;
   }
@@ -138,7 +148,8 @@ function parseSkillFrontmatter(content) {
 
   const frontmatter = match[1];
   const name = frontmatter.match(/^name:\s*(.+)$/m)?.[1]?.trim() || null;
-  const description = frontmatter.match(/^description:\s*(.+)$/m)?.[1]?.trim() || null;
+  const description =
+    frontmatter.match(/^description:\s*(.+)$/m)?.[1]?.trim() || null;
   return name ? { name, description } : null;
 }
 
@@ -179,10 +190,18 @@ export function scanCodexSkills(options = {}) {
   }
 
   const builtinSkills = [
-    { name: "web-clone", role: "general", description: "Clone and analyze web pages" },
+    {
+      name: "web-clone",
+      role: "general",
+      description: "Clone and analyze web pages",
+    },
     { name: "help", role: "general", description: "Show available commands" },
     { name: "note", role: "general", description: "Save notes during session" },
-    { name: "worker", role: "auto", description: "Spawn background worker for tasks" },
+    {
+      name: "worker",
+      role: "auto",
+      description: "Spawn background worker for tasks",
+    },
   ];
 
   for (const builtin of builtinSkills) {
@@ -207,15 +226,21 @@ export function probeTierEnvironment(options = {}) {
   const execSyncFn = options.execSyncFn || execSync;
   const codexAuth = preflight?.codex_plan ?? detectCodexAuthState({ homeDir });
 
-  const codexCheck = preflight?.codex || checkCliSync("codex", { whichCommandFn: options.whichCommandFn });
-  const geminiCheck = preflight?.gemini || checkCliSync("gemini", { whichCommandFn: options.whichCommandFn });
-  const hubCheck = preflight?.hub || checkHub({
-    pkgRoot: options.pkgRoot,
-    restart: options.hubRestart === true,
-    requestTimeoutMs: options.hubTimeoutMs ?? 1000,
-    pollAttempts: options.hubRestart === true ? 8 : 0,
-    execSyncFn,
-  });
+  const codexCheck =
+    preflight?.codex ||
+    checkCliSync("codex", { whichCommandFn: options.whichCommandFn });
+  const geminiCheck =
+    preflight?.gemini ||
+    checkCliSync("gemini", { whichCommandFn: options.whichCommandFn });
+  const hubCheck =
+    preflight?.hub ||
+    checkHub({
+      pkgRoot: options.pkgRoot,
+      restart: options.hubRestart === true,
+      requestTimeoutMs: options.hubTimeoutMs ?? 1000,
+      pollAttempts: options.hubRestart === true ? 8 : 0,
+      execSyncFn,
+    });
   const checks = {
     psmux: false,
     hub: !!hubCheck?.ok,
@@ -246,7 +271,8 @@ export function probeTierEnvironment(options = {}) {
 
   let tier = "minimal";
   if (checks.codex || checks.gemini) tier = "standard";
-  if (checks.psmux && checks.hub && (checks.codex || checks.gemini)) tier = "full";
+  if (checks.psmux && checks.hub && (checks.codex || checks.gemini))
+    tier = "full";
 
   const agents = ["claude"];
   if (checks.codex) agents.push("codex");
@@ -257,9 +283,10 @@ export function probeTierEnvironment(options = {}) {
     tier,
     checks,
     available_agents: agents,
-    codex_plan: codexAuth.source == null
-      ? { plan: codexAuth.plan }
-      : { plan: codexAuth.plan, source: codexAuth.source },
+    codex_plan:
+      codexAuth.source == null
+        ? { plan: codexAuth.plan }
+        : { plan: codexAuth.plan, source: codexAuth.source },
     source: {
       preflight: !!preflight,
       home_dir: homeDir,
@@ -272,13 +299,15 @@ function getCodexAuthFingerprint(options = {}) {
   if (typeof options.preflight?.codex_plan?.fingerprint === "string") {
     return options.preflight.codex_plan.fingerprint;
   }
-  return detectCodexAuthState({ homeDir: resolveHomeDir(options.homeDir) }).fingerprint;
+  return detectCodexAuthState({ homeDir: resolveHomeDir(options.homeDir) })
+    .fingerprint;
 }
 
 function hasAuthFingerprintChanged(target, options = {}) {
   if (!AUTH_SENSITIVE_TARGETS.has(target)) return false;
   const nextFingerprint = getCodexAuthFingerprint(options);
-  const previousFingerprint = readWarmupMetadata(options)?.codex_auth_fingerprint || null;
+  const previousFingerprint =
+    readWarmupMetadata(options)?.codex_auth_fingerprint || null;
   if (previousFingerprint === null) return false;
   return previousFingerprint !== nextFingerprint;
 }
@@ -314,7 +343,10 @@ export function extractProjectMeta(options = {}) {
       testCmd = pkg.scripts?.test || null;
       lang = "JavaScript/ESM (Node.js)";
     } catch {}
-  } else if (existsSync(join(cwd, "pyproject.toml")) || existsSync(join(cwd, "setup.py"))) {
+  } else if (
+    existsSync(join(cwd, "pyproject.toml")) ||
+    existsSync(join(cwd, "setup.py"))
+  ) {
     lang = "Python";
   } else if (existsSync(join(cwd, "Cargo.toml"))) {
     lang = "Rust";
@@ -333,7 +365,12 @@ export function extractProjectMeta(options = {}) {
 }
 
 function loadMcpInventory(options = {}) {
-  const inventoryPath = join(resolveHomeDir(options.homeDir), ".claude", "cache", "mcp-inventory.json");
+  const inventoryPath = join(
+    resolveHomeDir(options.homeDir),
+    ".claude",
+    "cache",
+    "mcp-inventory.json",
+  );
   try {
     return JSON.parse(readFileSync(inventoryPath, "utf8"));
   } catch {
@@ -372,7 +409,8 @@ function loadMcpConfigs(options = {}) {
 
 export function checkSearchEngines(options = {}) {
   const inventory = options.inventory ?? loadMcpInventory(options);
-  const configuredServers = options.configuredServers ?? loadMcpConfigs(options);
+  const configuredServers =
+    options.configuredServers ?? loadMcpConfigs(options);
   const engines = [];
 
   const knownSearchServers = [...SEARCH_SERVER_ORDER, "context7"];
@@ -383,8 +421,13 @@ export function checkSearchEngines(options = {}) {
       const scopeData = inventory[scope];
       if (!scopeData?.servers) continue;
       for (const server of scopeData.servers) {
-        const tags = server.domain_tags || MCP_SERVER_DOMAIN_TAGS[server.name] || [];
-        if (tags.includes("search") || tags.includes("web") || tags.includes("research")) {
+        const tags =
+          server.domain_tags || MCP_SERVER_DOMAIN_TAGS[server.name] || [];
+        if (
+          tags.includes("search") ||
+          tags.includes("web") ||
+          tags.includes("research")
+        ) {
           allServerNames.add(server.name);
         }
       }
@@ -393,7 +436,11 @@ export function checkSearchEngines(options = {}) {
 
   for (const name of Object.keys(configuredServers)) {
     const tags = MCP_SERVER_DOMAIN_TAGS[name] || [];
-    if (tags.includes("search") || tags.includes("web") || knownSearchServers.includes(name)) {
+    if (
+      tags.includes("search") ||
+      tags.includes("web") ||
+      knownSearchServers.includes(name)
+    ) {
       allServerNames.add(name);
     }
   }
@@ -405,7 +452,9 @@ export function checkSearchEngines(options = {}) {
     let inventoryStatus = null;
     if (inventory) {
       for (const scope of ["codex", "gemini", "claude"]) {
-        const server = inventory[scope]?.servers?.find((item) => item.name === name);
+        const server = inventory[scope]?.servers?.find(
+          (item) => item.name === name,
+        );
         if (server) {
           inventoryStatus = {
             scope,
@@ -418,7 +467,10 @@ export function checkSearchEngines(options = {}) {
     }
 
     let status = "unavailable";
-    if (inventoryStatus?.status === "enabled" || inventoryStatus?.status === "configured") {
+    if (
+      inventoryStatus?.status === "enabled" ||
+      inventoryStatus?.status === "configured"
+    ) {
       status = "available";
     } else if (configured) {
       status = "configured";
@@ -456,13 +508,18 @@ export function checkSearchEngines(options = {}) {
 
 function buildTarget(target, options = {}) {
   const filePath = resolveTargetPath(target, options);
-  if (!options.force && isFresh(target, options) && !hasAuthFingerprintChanged(target, options)) {
+  if (
+    !options.force &&
+    isFresh(target, options) &&
+    !hasAuthFingerprintChanged(target, options)
+  ) {
     return { target, status: "skipped", file: filePath, reason: "fresh" };
   }
 
   let payload;
   if (target === "codexSkills") payload = scanCodexSkills(options);
-  else if (target === "tierEnvironment") payload = probeTierEnvironment(options);
+  else if (target === "tierEnvironment")
+    payload = probeTierEnvironment(options);
   else if (target === "projectMeta") payload = extractProjectMeta(options);
   else if (target === "searchEngines") payload = checkSearchEngines(options);
   else throw new Error(`unknown cache target: ${target}`);
@@ -508,7 +565,9 @@ export function buildAll(options = {}) {
   }
 
   const built = results.filter((result) => result.status === "built").length;
-  const skipped = results.filter((result) => result.status === "skipped").length;
+  const skipped = results.filter(
+    (result) => result.status === "skipped",
+  ).length;
   const failed = results.filter((result) => result.status === "failed").length;
   const authFingerprint = getCodexAuthFingerprint(options);
 

package/scripts/claudemd-sync.mjs

@@ -1,8 +1,8 @@
 import { existsSync, readFileSync, writeFileSync } from "node:fs";
+import { homedir } from "node:os";
 import { join, resolve } from "node:path";
 import { fileURLToPath } from "node:url";
-import { homedir } from "node:os";
-import { TFX_START, OMC_END, writeSection } from "./lib/claudemd-scanner.mjs";
+import { OMC_END, TFX_START, writeSection } from "./lib/claudemd-scanner.mjs";
 
 const PKG_ROOT = fileURLToPath(new URL("..", import.meta.url));
 const GLOBAL_CLAUDE_MD_PATH = join(homedir(), ".claude", "CLAUDE.md");
@@ -29,7 +29,10 @@ function findRoutingSection(markdown) {
   }
 
   // Legacy heading fallback
-  const headingPattern = new RegExp(`(^|\\n)${ROUTING_SECTION_HEADING.replace(/[.*+?^${}()|[\]\\]/gu, "\\$&")}(?=\\n|$)`, "u");
+  const headingPattern = new RegExp(
+    `(^|\\n)${ROUTING_SECTION_HEADING.replace(/[.*+?^${}()|[\]\\]/gu, "\\$&")}(?=\\n|$)`,
+    "u",
+  );
   const match = headingPattern.exec(content);
 
   if (!match) {
@@ -37,8 +40,12 @@ function findRoutingSection(markdown) {
   }
 
   const startIndex = match.index + match[1].length;
-  const nextHeadingIndex = content.indexOf("\n## ", startIndex + ROUTING_SECTION_HEADING.length);
-  const endIndex = nextHeadingIndex === -1 ? content.length : nextHeadingIndex + 1;
+  const nextHeadingIndex = content.indexOf(
+    "\n## ",
+    startIndex + ROUTING_SECTION_HEADING.length,
+  );
+  const endIndex =
+    nextHeadingIndex === -1 ? content.length : nextHeadingIndex + 1;
 
   return {
     found: true,
@@ -66,7 +73,11 @@ function buildNextMarkdown(currentMarkdown, routingSection) {
     return nextSection;
   }
 
-  const separator = current.endsWith("\n\n") ? "" : current.endsWith("\n") ? "\n" : "\n\n";
+  const separator = current.endsWith("\n\n")
+    ? ""
+    : current.endsWith("\n")
+      ? "\n"
+      : "\n\n";
   return `${current}${separator}${nextSection}`;
 }
 
@@ -82,7 +93,9 @@ export function getLatestRoutingTable() {
     if (section.found) return section.section.trim();
   }
   // 2차 fallback: 패키지 CLAUDE.md도 없으면 에러
-  throw new Error(`routing section not found in: ${GLOBAL_CLAUDE_MD_PATH} or ${PKG_CLAUDE_MD_PATH}`);
+  throw new Error(
+    `routing section not found in: ${GLOBAL_CLAUDE_MD_PATH} or ${PKG_CLAUDE_MD_PATH}`,
+  );
 }
 
 export function ensureTfxSection(claudeMdPath, routingTable) {
@@ -132,15 +145,12 @@ export function ensureTfxCrown(claudeMdPath, options = {}) {
 }
 
 export function ensureGlobalClaudeRoutingSection(claudeDir) {
+  // routing은 프로젝트 CLAUDE.md에만 유지. global 중복 주입 중단.
   const claudeMdPath = join(claudeDir, "CLAUDE.md");
-  if (!existsSync(claudeMdPath)) {
-    return toSkippedResult(claudeMdPath, "missing_file");
-  }
-
-  try {
-    return ensureTfxSection(claudeMdPath, getLatestRoutingTable());
-  } catch (error) {
-    const reason = error instanceof Error ? error.message : "routing_table_unavailable";
-    return toSkippedResult(claudeMdPath, reason);
-  }
+  return {
+    action: "unchanged",
+    path: claudeMdPath,
+    skipped: true,
+    reason: "global_sync_disabled",
+  };
 }

package/scripts/codex-gateway-preflight.mjs

@@ -4,10 +4,10 @@
 // gateway가 alive인지 확인하고 죽었으면 기동한다.
 // 실제 MCP 기능은 없음 (no-op). 역할은 gateway 보장뿐.
 
-import { existsSync, readFileSync, writeFileSync } from 'node:fs';
-import { join, dirname } from 'node:path';
-import { fileURLToPath } from 'node:url';
-import { tmpdir } from 'node:os';
+import { existsSync, readFileSync, writeFileSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
 
 const PLUGIN_ROOT = dirname(dirname(fileURLToPath(import.meta.url)));
 const PROBE_PORT = 8100;
@@ -15,21 +15,25 @@ const PROBE_TIMEOUT_MS = 2000;
 const STARTUP_WAIT_MS = 6000;
 const POLL_MS = 500;
 const CACHE_TTL_MS = 5 * 60 * 1000; // 5분
-const CACHE_FILE = join(tmpdir(), 'tfx-gateway-alive.json');
+const CACHE_FILE = join(tmpdir(), "tfx-gateway-alive.json");
 
 function readCache() {
   try {
     if (!existsSync(CACHE_FILE)) return null;
-    const data = JSON.parse(readFileSync(CACHE_FILE, 'utf8'));
+    const data = JSON.parse(readFileSync(CACHE_FILE, "utf8"));
     if (Date.now() - data.ts < CACHE_TTL_MS) return data;
-  } catch { /* ignore */ }
+  } catch {
+    /* ignore */
+  }
   return null;
 }
 
 function writeCache() {
   try {
     writeFileSync(CACHE_FILE, JSON.stringify({ ts: Date.now(), alive: true }));
-  } catch { /* ignore */ }
+  } catch {
+    /* ignore */
+  }
 }
 
 async function isGatewayAlive() {
@@ -41,7 +45,10 @@ async function isGatewayAlive() {
     const res = await fetch(`http://127.0.0.1:${PROBE_PORT}/healthz`, {
       signal: AbortSignal.timeout(PROBE_TIMEOUT_MS),
     });
-    if (res.ok) { writeCache(); return true; }
+    if (res.ok) {
+      writeCache();
+      return true;
+    }
     return false;
   } catch {
     return false;
@@ -49,16 +56,18 @@ async function isGatewayAlive() {
 }
 
 async function startGateway() {
-  const script = join(PLUGIN_ROOT, 'scripts', 'mcp-gateway-start.mjs');
+  const script = join(PLUGIN_ROOT, "scripts", "mcp-gateway-start.mjs");
   if (!existsSync(script)) {
-    process.stderr.write('[gateway-preflight] mcp-gateway-start.mjs not found\n');
+    process.stderr.write(
+      "[gateway-preflight] mcp-gateway-start.mjs not found\n",
+    );
     return false;
   }
 
-  const { execSync } = await import('node:child_process');
+  const { execSync } = await import("node:child_process");
   try {
     execSync(`node "${script}"`, {
-      stdio: 'ignore',
+      stdio: "ignore",
       timeout: STARTUP_WAIT_MS + 2000,
       cwd: PLUGIN_ROOT,
     });
@@ -81,53 +90,59 @@ async function main() {
   // 1) gateway 보장
   const alive = await isGatewayAlive();
   if (!alive) {
-    process.stderr.write('[gateway-preflight] gateway down, starting...\n');
+    process.stderr.write("[gateway-preflight] gateway down, starting...\n");
     const ok = await startGateway();
-    process.stderr.write(ok
-      ? '[gateway-preflight] gateway started\n'
-      : '[gateway-preflight] gateway start failed\n');
+    process.stderr.write(
+      ok
+        ? "[gateway-preflight] gateway started\n"
+        : "[gateway-preflight] gateway start failed\n",
+    );
   }
 
   // 2) MCP JSON-RPC stdio — initialize 핸드셰이크만 처리하고 idle 유지
-  const { createInterface } = await import('node:readline');
+  const { createInterface } = await import("node:readline");
   const rl = createInterface({ input: process.stdin });
 
-  rl.on('line', (line) => {
+  rl.on("line", (line) => {
     try {
       const msg = JSON.parse(line);
-      if (msg.method === 'initialize') {
+      if (msg.method === "initialize") {
         const response = {
-          jsonrpc: '2.0',
+          jsonrpc: "2.0",
           id: msg.id,
           result: {
-            protocolVersion: '2024-11-05',
+            protocolVersion: "2024-11-05",
             capabilities: {},
-            serverInfo: { name: 'tfx-gateway-preflight', version: '1.0.0' },
+            serverInfo: { name: "tfx-gateway-preflight", version: "1.0.0" },
           },
         };
-        process.stdout.write(JSON.stringify(response) + '\n');
-      } else if (msg.method === 'notifications/initialized') {
+        process.stdout.write(JSON.stringify(response) + "\n");
+      } else if (msg.method === "notifications/initialized") {
         // ack, no response needed
-      } else if (msg.method === 'tools/list') {
-        process.stdout.write(JSON.stringify({
-          jsonrpc: '2.0',
-          id: msg.id,
-          result: { tools: [] },
-        }) + '\n');
+      } else if (msg.method === "tools/list") {
+        process.stdout.write(
+          JSON.stringify({
+            jsonrpc: "2.0",
+            id: msg.id,
+            result: { tools: [] },
+          }) + "\n",
+        );
       } else if (msg.id !== undefined) {
         // unknown method with id — respond empty
-        process.stdout.write(JSON.stringify({
-          jsonrpc: '2.0',
-          id: msg.id,
-          result: {},
-        }) + '\n');
+        process.stdout.write(
+          JSON.stringify({
+            jsonrpc: "2.0",
+            id: msg.id,
+            result: {},
+          }) + "\n",
+        );
       }
     } catch {
       // ignore parse errors
     }
   });
 
-  rl.on('close', () => process.exit(0));
+  rl.on("close", () => process.exit(0));
 }
 
 main();