triflux 10.3.4 → 10.7.0

package/scripts/mcp-check.mjs

@@ -1,19 +1,28 @@
 #!/usr/bin/env node
 // MCP inventory cache for dynamic MCP filtering.
 
-import { execSync } from 'node:child_process';
-import { existsSync, mkdirSync, readFileSync, readdirSync, writeFileSync } from 'node:fs';
-import { homedir } from 'node:os';
-import { dirname, join, resolve } from 'node:path';
-import { fileURLToPath } from 'node:url';
-
-import { MCP_SERVER_TOOL_CATALOG, normalizeServerMetadata } from './lib/mcp-server-catalog.mjs';
-
-const CACHE_DIR = join(homedir(), '.claude', 'cache');
-const CACHE_FILE = join(CACHE_DIR, 'mcp-inventory.json');
+import { execSync } from "node:child_process";
+import {
+  existsSync,
+  mkdirSync,
+  readdirSync,
+  readFileSync,
+  writeFileSync,
+} from "node:fs";
+import { homedir } from "node:os";
+import { dirname, join, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+
+import {
+  MCP_SERVER_TOOL_CATALOG,
+  normalizeServerMetadata,
+} from "./lib/mcp-server-catalog.mjs";
+
+const CACHE_DIR = join(homedir(), ".claude", "cache");
+const CACHE_FILE = join(CACHE_DIR, "mcp-inventory.json");
 
 function countConfiguredTools(config = {}, fallbackToolCount = 0) {
-  const directKeys = ['tools', 'toolNames', 'allowedTools', 'includeTools'];
+  const directKeys = ["tools", "toolNames", "allowedTools", "includeTools"];
   for (const key of directKeys) {
     if (Array.isArray(config[key])) return config[key].length;
   }
@@ -26,7 +35,7 @@ function countConfiguredTools(config = {}, fallbackToolCount = 0) {
 }
 
 export function createServerRecord(name, status, config = {}) {
-  const normalizedName = typeof name === 'string' ? name.trim() : '';
+  const normalizedName = typeof name === "string" ? name.trim() : "";
   const fallback = normalizeServerMetadata(normalizedName, {});
   const toolCount = countConfiguredTools(config, fallback.tool_count);
   const domainTags = Array.isArray(config.domain_tags)
@@ -51,13 +60,16 @@ export function createServerRecord(name, status, config = {}) {
 
 export function getCodexMcp() {
   try {
-    const output = execSync('codex mcp list', {
-      encoding: 'utf8',
+    const output = execSync("codex mcp list", {
+      encoding: "utf8",
       timeout: 15000,
-      stdio: ['pipe', 'pipe', 'ignore'],
+      stdio: ["pipe", "pipe", "ignore"],
       windowsHide: true,
     });
-    const lines = output.trim().split(/\r?\n/).filter((line) => line.trim());
+    const lines = output
+      .trim()
+      .split(/\r?\n/)
+      .filter((line) => line.trim());
     if (lines.length < 2) return [];
 
     const servers = [];
@@ -67,8 +79,8 @@ export function getCodexMcp() {
 
       const name = cols[0].trim();
       const statusMatch = lines[i].match(/\b(enabled|disabled)\b/i);
-      const status = statusMatch ? statusMatch[1].toLowerCase() : 'unknown';
-      if (!name || name.startsWith('-')) continue;
+      const status = statusMatch ? statusMatch[1].toLowerCase() : "unknown";
+      if (!name || name.startsWith("-")) continue;
       servers.push(createServerRecord(name, status));
     }
     return servers;
@@ -79,12 +91,14 @@ export function getCodexMcp() {
 
 export function getGeminiMcp() {
   try {
-    const settingsPath = join(homedir(), '.gemini', 'settings.json');
+    const settingsPath = join(homedir(), ".gemini", "settings.json");
     if (!existsSync(settingsPath)) return null;
 
-    const settings = JSON.parse(readFileSync(settingsPath, 'utf8'));
+    const settings = JSON.parse(readFileSync(settingsPath, "utf8"));
     const mcpServers = settings.mcpServers || {};
-    return Object.entries(mcpServers).map(([name, config]) => createServerRecord(name, 'configured', config || {}));
+    return Object.entries(mcpServers).map(([name, config]) =>
+      createServerRecord(name, "configured", config || {}),
+    );
   } catch {
     return null;
   }
@@ -92,20 +106,20 @@ export function getGeminiMcp() {
 
 // ── Claude MCP 서버 발견 ──
 
-const CLAUDE_DIR = join(homedir(), '.claude');
+const CLAUDE_DIR = join(homedir(), ".claude");
 
 // Anthropic 클라우드 호스팅 MCP 서버 — Claude Code 런타임에서 항상 가용.
 // mcp-server-catalog.mjs의 MCP_SERVER_TOOL_CATALOG에 정의된 서버 중
 // 로컬 설치가 불필요한 클라우드 제공 서버.
 const WELL_KNOWN_CLOUD_SERVERS = Object.freeze([
-  'brave-search',
-  'exa',
-  'context7',
+  "brave-search",
+  "exa",
+  "context7",
 ]);
 
 function readJsonSafe(filePath) {
   try {
-    return JSON.parse(readFileSync(filePath, 'utf8'));
+    return JSON.parse(readFileSync(filePath, "utf8"));
   } catch {
     return null;
   }
@@ -113,9 +127,9 @@ function readJsonSafe(filePath) {
 
 function extractMcpServerNames(mcpJsonPath) {
   const data = readJsonSafe(mcpJsonPath);
-  if (!data?.mcpServers || typeof data.mcpServers !== 'object') return [];
+  if (!data?.mcpServers || typeof data.mcpServers !== "object") return [];
   return Object.entries(data.mcpServers)
-    .filter(([name]) => typeof name === 'string' && name.trim())
+    .filter(([name]) => typeof name === "string" && name.trim())
     .map(([name, config]) => ({ name: name.trim(), config: config || {} }));
 }
 
@@ -123,7 +137,7 @@ function walkUpForMcpJson(startDir, maxDepth = 5) {
   const found = [];
   let dir = resolve(startDir);
   for (let i = 0; i < maxDepth; i += 1) {
-    const candidate = join(dir, '.mcp.json');
+    const candidate = join(dir, ".mcp.json");
     if (existsSync(candidate)) found.push(candidate);
     const parent = dirname(dir);
     if (parent === dir) break;
@@ -133,22 +147,24 @@ function walkUpForMcpJson(startDir, maxDepth = 5) {
 }
 
 function scanPluginsMcpJson() {
-  const pluginsDir = join(CLAUDE_DIR, 'plugins');
+  const pluginsDir = join(CLAUDE_DIR, "plugins");
   if (!existsSync(pluginsDir)) return [];
   const found = [];
   const walk = (dir, depth = 0) => {
     if (depth > 4) return;
     try {
       for (const entry of readdirSync(dir, { withFileTypes: true })) {
-        if (entry.name === 'node_modules' || entry.name === '.git') continue;
+        if (entry.name === "node_modules" || entry.name === ".git") continue;
         const full = join(dir, entry.name);
-        if (entry.isFile() && entry.name === '.mcp.json') {
+        if (entry.isFile() && entry.name === ".mcp.json") {
           found.push(full);
         } else if (entry.isDirectory()) {
           walk(full, depth + 1);
         }
       }
-    } catch { /* permission errors */ }
+    } catch {
+      /* permission errors */
+    }
   };
   walk(pluginsDir);
   return found;
@@ -161,7 +177,7 @@ export function getClaudeMcp(cwd = process.cwd()) {
   for (const mcpJson of walkUpForMcpJson(cwd)) {
     for (const { name, config } of extractMcpServerNames(mcpJson)) {
       if (!serverMap.has(name)) {
-        serverMap.set(name, createServerRecord(name, 'configured', config));
+        serverMap.set(name, createServerRecord(name, "configured", config));
       }
     }
   }
@@ -170,19 +186,22 @@ export function getClaudeMcp(cwd = process.cwd()) {
   for (const mcpJson of scanPluginsMcpJson()) {
     for (const { name, config } of extractMcpServerNames(mcpJson)) {
       if (!serverMap.has(name)) {
-        serverMap.set(name, createServerRecord(name, 'configured', config));
+        serverMap.set(name, createServerRecord(name, "configured", config));
       }
     }
   }
 
   // 3) ~/.claude/settings.json + settings.local.json의 mcpServers
-  for (const settingsFile of ['settings.json', 'settings.local.json']) {
+  for (const settingsFile of ["settings.json", "settings.local.json"]) {
     const data = readJsonSafe(join(CLAUDE_DIR, settingsFile));
     if (!data?.mcpServers) continue;
     for (const [name, config] of Object.entries(data.mcpServers)) {
-      if (typeof name !== 'string' || !name.trim()) continue;
+      if (typeof name !== "string" || !name.trim()) continue;
       if (!serverMap.has(name.trim())) {
-        serverMap.set(name.trim(), createServerRecord(name.trim(), 'configured', config || {}));
+        serverMap.set(
+          name.trim(),
+          createServerRecord(name.trim(), "configured", config || {}),
+        );
       }
     }
   }
@@ -191,7 +210,7 @@ export function getClaudeMcp(cwd = process.cwd()) {
   for (const name of WELL_KNOWN_CLOUD_SERVERS) {
     if (serverMap.has(name)) continue;
     if (!MCP_SERVER_TOOL_CATALOG[name]) continue;
-    serverMap.set(name, createServerRecord(name, 'available'));
+    serverMap.set(name, createServerRecord(name, "available"));
   }
 
   return [...serverMap.values()];

package/scripts/mcp-gateway-config.mjs

@@ -3,37 +3,63 @@
 // Usage: node mcp-gateway-config.mjs --enable   # stdio → SSE
 //        node mcp-gateway-config.mjs --disable  # SSE → stdio (복원)
 
-import { execSync } from 'node:child_process';
-import { existsSync, readFileSync, writeFileSync, mkdirSync } from 'node:fs';
-import { homedir } from 'node:os';
-import { join, dirname } from 'node:path';
-import { isServerEnabled } from './lib/mcp-manifest.mjs';
+import { execSync } from "node:child_process";
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { dirname, join } from "node:path";
+import { isServerEnabled } from "./lib/mcp-manifest.mjs";
 
-const BACKUP_FILE = join(homedir(), '.claude', 'cache', 'mcp-pre-gateway.json');
+const BACKUP_FILE = join(homedir(), ".claude", "cache", "mcp-pre-gateway.json");
 
 export const GATEWAY_SERVERS = [
-  { name: 'context7',     port: 8100, stdioCmd: 'cmd /c npx -y @upstash/context7-mcp@latest' },
-  { name: 'brave-search', port: 8101, stdioCmd: 'cmd /c npx -y @brave/brave-search-mcp-server' },
-  { name: 'exa',          port: 8102, stdioCmd: 'cmd /c npx -y exa-mcp-server' },
-  { name: 'tavily',       port: 8103, stdioCmd: 'cmd /c npx -y tavily-mcp@latest' },
-  { name: 'jira',         port: 8104, stdioCmd: 'cmd /c npx -y mcp-jira-cloud@latest' },
-  { name: 'serena',       port: 8105, stdioCmd: 'uvx --from git+https://github.com/oraios/serena serena start-mcp-server' },
-  { name: 'notion',       port: 8106, stdioCmd: 'cmd /c npx -y @notionhq/notion-mcp-server' },
-  { name: 'notion-guest', port: 8107, stdioCmd: 'cmd /c npx -y @notionhq/notion-mcp-server' },
+  {
+    name: "context7",
+    port: 8100,
+    stdioCmd: "cmd /c npx -y @upstash/context7-mcp@latest",
+  },
+  {
+    name: "brave-search",
+    port: 8101,
+    stdioCmd: "cmd /c npx -y @brave/brave-search-mcp-server",
+  },
+  { name: "exa", port: 8102, stdioCmd: "cmd /c npx -y exa-mcp-server" },
+  { name: "tavily", port: 8103, stdioCmd: "cmd /c npx -y tavily-mcp@latest" },
+  { name: "jira", port: 8104, stdioCmd: "cmd /c npx -y mcp-jira-cloud@latest" },
+  {
+    name: "serena",
+    port: 8105,
+    stdioCmd:
+      "uvx --from git+https://github.com/oraios/serena serena start-mcp-server",
+  },
+  {
+    name: "notion",
+    port: 8106,
+    stdioCmd: "cmd /c npx -y @notionhq/notion-mcp-server",
+  },
+  {
+    name: "notion-guest",
+    port: 8107,
+    stdioCmd: "cmd /c npx -y @notionhq/notion-mcp-server",
+  },
 ];
 
 const SKIP_SERVERS = new Set([
-  'playwright',
-  'claude.ai Notion',
-  'plugin:oh-my-claudecode:t',
+  "playwright",
+  "claude.ai Notion",
+  "plugin:oh-my-claudecode:t",
 ]);
 
 // Git Bash에서 /c → C:/ 경로 변환 방지
-const EXEC_ENV = { ...process.env, MSYS_NO_PATHCONV: '1' };
+const EXEC_ENV = { ...process.env, MSYS_NO_PATHCONV: "1" };
 
 function run(cmd) {
   try {
-    execSync(cmd, { stdio: 'pipe', encoding: 'utf8', timeout: 15000, env: EXEC_ENV });
+    execSync(cmd, {
+      stdio: "pipe",
+      encoding: "utf8",
+      timeout: 15000,
+      env: EXEC_ENV,
+    });
     return true;
   } catch {
     return false;
@@ -54,16 +80,22 @@ function captureCurrentMcpState() {
     // claude mcp get으로 현재 등록 상태 확인
     try {
       const out = execSync(`claude mcp get "${name}" -s user`, {
-        stdio: 'pipe', encoding: 'utf8', timeout: 5000, env: EXEC_ENV,
+        stdio: "pipe",
+        encoding: "utf8",
+        timeout: 5000,
+        env: EXEC_ENV,
       }).trim();
-      servers[name] = { scope: 'user', raw: out };
+      servers[name] = { scope: "user", raw: out };
     } catch {
       // user에 없으면 local 확인
       try {
         const out = execSync(`claude mcp get "${name}" -s local`, {
-          stdio: 'pipe', encoding: 'utf8', timeout: 5000, env: EXEC_ENV,
+          stdio: "pipe",
+          encoding: "utf8",
+          timeout: 5000,
+          env: EXEC_ENV,
         }).trim();
-        servers[name] = { scope: 'local', raw: out };
+        servers[name] = { scope: "local", raw: out };
       } catch {
         servers[name] = null; // 기존에 없었음
       }
@@ -83,14 +115,16 @@ function saveBackup(servers) {
 function loadBackup() {
   if (!existsSync(BACKUP_FILE)) return null;
   try {
-    return JSON.parse(readFileSync(BACKUP_FILE, 'utf8'));
-  } catch { return null; }
+    return JSON.parse(readFileSync(BACKUP_FILE, "utf8"));
+  } catch {
+    return null;
+  }
 }
 
 // ── enable: 스냅샷 → remove → SSE add (실패 시 rollback) ──
 
 function enableSse() {
-  console.log('Switching MCP servers to SSE mode...\n');
+  console.log("Switching MCP servers to SSE mode...\n");
 
   // 1) 현재 상태 스냅샷
   const snapshot = captureCurrentMcpState();
@@ -108,7 +142,9 @@ function enableSse() {
 
     removeMcp(name);
     const url = `http://localhost:${port}/sse`;
-    const success = run(`claude mcp add --transport sse -s user "${name}" ${url}`);
+    const success = run(
+      `claude mcp add --transport sse -s user "${name}" ${url}`,
+    );
 
     if (success) {
       console.log(`  [SSE] ${name} → ${url}`);
@@ -119,9 +155,11 @@ function enableSse() {
       const orig = snapshot[name];
       if (orig) {
         // H1 fix: orig.raw를 shell-escape하여 injection 방지
-      const safeRaw = (orig.raw || '').replace(/[;`$(){}|&<>]/g, '');
-      const restored = safeRaw ? run(`claude mcp add "${name}" -s ${orig.scope} -- ${safeRaw}`) : false;
-        console.error(`  [ROLLBACK] ${name}: ${restored ? 'ok' : 'FAIL'}`);
+        const safeRaw = (orig.raw || "").replace(/[;`$(){}|&<>]/g, "");
+        const restored = safeRaw
+          ? run(`claude mcp add "${name}" -s ${orig.scope} -- ${safeRaw}`)
+          : false;
+        console.error(`  [ROLLBACK] ${name}: ${restored ? "ok" : "FAIL"}`);
       }
       fail++;
     }
@@ -133,12 +171,14 @@ function enableSse() {
 // ── disable: 백업에서 서버별 원복 ──
 
 function disableSse() {
-  console.log('Restoring MCP servers from backup...\n');
+  console.log("Restoring MCP servers from backup...\n");
   const backup = loadBackup();
 
   // C1 fix: 백업 없으면 전체 삭제 방지
   if (!backup) {
-    console.error('No backup found — cannot restore. Run --enable first to create a backup.');
+    console.error(
+      "No backup found — cannot restore. Run --enable first to create a backup.",
+    );
     process.exit(1);
   }
 
@@ -160,9 +200,11 @@ function disableSse() {
 
     // H2 fix: 백업의 scope/raw를 사용하여 원본 복원, fallback으로 stdioCmd
     removeMcp(name);
-    const restoreScope = orig.scope || 'user';
+    const restoreScope = orig.scope || "user";
     const restoreCmd = orig.raw?.trim() ? orig.raw.trim() : stdioCmd;
-    const success = run(`claude mcp add "${name}" -s ${restoreScope} -- ${restoreCmd}`);
+    const success = run(
+      `claude mcp add "${name}" -s ${restoreScope} -- ${restoreCmd}`,
+    );
 
     if (success) {
       console.log(`  [RESTORE] ${name} → scope=${restoreScope}`);
@@ -171,7 +213,9 @@ function disableSse() {
       // fallback: stdioCmd로 재시도
       const fallback = run(`claude mcp add "${name}" -s user -- ${stdioCmd}`);
       if (fallback) {
-        console.log(`  [FALLBACK] ${name} → stdio (원본 복원 실패, 기본값 사용)`);
+        console.log(
+          `  [FALLBACK] ${name} → stdio (원본 복원 실패, 기본값 사용)`,
+        );
         ok++;
       } else {
         console.error(`  [FAIL] ${name}`);
@@ -190,16 +234,16 @@ function printUsage() {
   --enable   Switch Claude Code MCP servers from stdio to SSE (supergateway)
   --disable  Restore Claude Code MCP servers to original stdio mode
 
-Servers managed: ${GATEWAY_SERVERS.map((s) => s.name).join(', ')}
-Servers skipped: ${[...SKIP_SERVERS].join(', ')}`);
+Servers managed: ${GATEWAY_SERVERS.map((s) => s.name).join(", ")}
+Servers skipped: ${[...SKIP_SERVERS].join(", ")}`);
 }
 
 // ── main ──
 const flag = process.argv[2];
 
-if (flag === '--enable') {
+if (flag === "--enable") {
   enableSse();
-} else if (flag === '--disable') {
+} else if (flag === "--disable") {
   disableSse();
 } else {
   printUsage();

package/scripts/mcp-gateway-ensure.mjs

@@ -1,24 +1,21 @@
 #!/usr/bin/env node
+
 // mcp-gateway-ensure.mjs — SessionStart 훅에서 supergateway MCP 서비스 보장
 // hub-ensure.mjs 패턴을 따름. 가볍게 헬스체크만 수행하고 필요시 기동.
 
-import { existsSync, } from 'node:fs';
-import { join, dirname } from 'node:path';
-import { execSync } from 'node:child_process';
-import { tmpdir } from 'node:os';
-import { fileURLToPath } from 'node:url';
+import { execSync } from "node:child_process";
+import { existsSync } 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 PID_FILE = join(tmpdir(), 'tfx-gateway-pids.json');
+const PID_FILE = join(tmpdir(), "tfx-gateway-pids.json");
 const PROBE_PORT = 8100; // context7 — 첫 번째 게이트웨이 포트로 alive 프로브
 const PROBE_TIMEOUT_MS = 1500;
 const STARTUP_WAIT_MS = 4000;
 const POLL_INTERVAL_MS = 500;
 
-/**
- * 단일 포트 /healthz 프로브로 게이트웨이 클러스터 alive 판정.
- * 모든 포트를 체크하면 hook timeout(8s)에 걸리므로 대표 포트 1개만 확인.
- */
 async function isGatewayAlive() {
   try {
     const res = await fetch(`http://127.0.0.1:${PROBE_PORT}/healthz`, {
@@ -30,56 +27,67 @@ async function isGatewayAlive() {
   }
 }
 
-/** 매니페스트 파일 존재 여부로 gateway 설치 판정 (빠른 경로) */
 function hasManifest() {
   return existsSync(PID_FILE);
 }
 
-/** mcp-gateway-start.mjs를 독립 프로세스로 기동 */
 function startGateway() {
-  const scriptPath = join(PLUGIN_ROOT, 'scripts', 'mcp-gateway-start.mjs');
+  const scriptPath = join(PLUGIN_ROOT, "scripts", "mcp-gateway-start.mjs");
   if (!existsSync(scriptPath)) return false;
 
   try {
-    // PowerShell Start-Process: Windows Job Object에서 벗어나 부모 종료 후 생존
     execSync(
-      `powershell -NoProfile -Command "Start-Process -WindowStyle Hidden -FilePath '${process.execPath}' -ArgumentList '${scriptPath.replaceAll("'", "''")}'"`
-    , { stdio: 'ignore', timeout: 10000 });
+      `powershell -NoProfile -Command "Start-Process -WindowStyle Hidden -FilePath '${process.execPath}' -ArgumentList '${scriptPath.replaceAll("'", "''")}'"`,
+      { stdio: "ignore", timeout: 10000 },
+    );
     return true;
   } catch {
     return false;
   }
 }
 
-/** 게이트웨이 기동 후 프로브 포트 ready 대기 */
 async function waitForGatewayReady(maxWaitMs = STARTUP_WAIT_MS) {
   const deadline = Date.now() + maxWaitMs;
   while (Date.now() < deadline) {
     if (await isGatewayAlive()) return true;
-    await new Promise((r) => setTimeout(r, POLL_INTERVAL_MS));
+    await new Promise((resolve) => setTimeout(resolve, POLL_INTERVAL_MS));
   }
   return false;
 }
 
-// ── main ──
+export async function run(stdinData) {
+  void stdinData;
 
-// 빠른 경로: 매니페스트 존재 + 프로브 포트 살아있으면 즉시 OK
-if (hasManifest() && await isGatewayAlive()) {
-  process.stdout.write('gateway: ok');
-  process.exit(0);
-}
+  if (hasManifest() && (await isGatewayAlive())) {
+    return { code: 0, stdout: "gateway: ok", stderr: "" };
+  }
 
-// 매니페스트 없으면 gateway가 설정되지 않은 상태 — 조용히 스킵
-if (!hasManifest()) {
-  process.stdout.write('gateway: not configured');
-  process.exit(0);
-}
+  if (!hasManifest()) {
+    return { code: 0, stdout: "gateway: not configured", stderr: "" };
+  }
+
+  const started = startGateway();
+  if (!started) {
+    return { code: 0, stdout: "", stderr: "[gateway-ensure] start failed" };
+  }
 
-// 느린 경로: 게이트웨이 기동 시도
-const started = startGateway();
-if (started) {
   const ready = await waitForGatewayReady();
-  process.stdout.write(ready ? 'gateway: ok' : 'gateway: starting');
-} else {
-  process.stderr.write('[gateway-ensure] start failed');
+  return {
+    code: 0,
+    stdout: ready ? "gateway: ok" : "gateway: starting",
+    stderr: "",
+  };
+}
+
+const isMain =
+  process.argv[1] &&
+  import.meta.url.endsWith(
+    process.argv[1].replace(/\\/g, "/").split("/").pop(),
+  );
+
+if (isMain) {
+  const result = await run();
+  if (result.stdout) process.stdout.write(result.stdout);
+  if (result.stderr) process.stderr.write(result.stderr);
+  process.exit(result.code);
 }