triflux 3.3.0-dev.1 → 3.3.0-dev.5

package/scripts/lib/mcp-server-catalog.mjs

@@ -0,0 +1,118 @@
+export const SEARCH_SERVER_ORDER = Object.freeze(['brave-search', 'tavily', 'exa']);
+
+export const MCP_SERVER_TOOL_CATALOG = Object.freeze({
+  context7: Object.freeze(['resolve-library-id', 'query-docs']),
+  'brave-search': Object.freeze(['brave_web_search', 'brave_news_search']),
+  exa: Object.freeze(['web_search_exa', 'get_code_context_exa']),
+  tavily: Object.freeze(['tavily_search', 'tavily_extract']),
+  playwright: Object.freeze([
+    'browser_navigate',
+    'browser_navigate_back',
+    'browser_snapshot',
+    'browser_take_screenshot',
+    'browser_wait_for',
+  ]),
+  'sequential-thinking': Object.freeze(['sequentialthinking']),
+});
+
+export const MCP_SERVER_DOMAIN_TAGS = Object.freeze({
+  context7: Object.freeze(['docs', 'reference', 'api', 'sdk', 'library']),
+  'brave-search': Object.freeze(['web', 'search', 'news', 'current']),
+  exa: Object.freeze(['code', 'repository', 'examples', 'search']),
+  tavily: Object.freeze(['research', 'search', 'news', 'verification', 'current']),
+  playwright: Object.freeze(['browser', 'ui', 'visual', 'e2e']),
+  'sequential-thinking': Object.freeze(['analysis', 'planning', 'reasoning', 'security', 'review']),
+});
+
+export const DOMAIN_TAG_KEYWORDS = Object.freeze({
+  docs: Object.freeze(['docs', 'documentation', 'manual', 'guide', '문서', '가이드', '매뉴얼']),
+  reference: Object.freeze(['reference', 'spec', 'schema', 'official', '레퍼런스', '공식', '스펙', '스키마']),
+  api: Object.freeze(['api', 'endpoint', 'interface', 'sdk', '호출', '엔드포인트']),
+  sdk: Object.freeze(['sdk', 'library', 'package', 'framework', '라이브러리', '패키지', '프레임워크']),
+  library: Object.freeze(['library', 'package', 'framework', 'module', '라이브러리', '패키지', '모듈']),
+  web: Object.freeze(['web', 'site', 'article', 'forum', 'blog', 'reddit', '웹', '사이트', '기사', '포럼', '블로그']),
+  search: Object.freeze(['search', 'browse', 'lookup', 'find', '검색', '조회', '탐색', '찾아']),
+  news: Object.freeze(['latest', 'recent', 'news', 'today', 'release', 'announcement', '최신', '최근', '뉴스', '오늘', '릴리즈', '공지']),
+  current: Object.freeze(['current', 'status', 'pricing', 'changelog', 'up-to-date', '현재', '상태', '가격', '변경사항']),
+  research: Object.freeze(['research', 'verify', 'fact-check', 'investigate', '리서치', '검증', '조사']),
+  verification: Object.freeze(['verify', 'validation', 'fact-check', 'audit', '검증', '확인', '감사']),
+  code: Object.freeze(['code', 'repo', 'repository', 'source', 'implementation', 'bug', 'fix', 'test', 'snippet', 'cli', '코드', '리포', '저장소', '구현', '버그', '테스트', '예제', '스크립트']),
+  repository: Object.freeze(['repo', 'repository', 'source', 'git', 'github', '리포', '저장소', '소스']),
+  examples: Object.freeze(['example', 'examples', 'snippet', 'sample', '예제', '샘플']),
+  browser: Object.freeze(['browser', 'page', 'dom', 'screenshot', 'render', '브라우저', '페이지', '스크린샷', '렌더']),
+  ui: Object.freeze(['ui', 'ux', 'layout', 'responsive', 'css', 'html', '디자인', '레이아웃', '반응형']),
+  visual: Object.freeze(['visual', 'screenshot', 'layout', 'render', 'screen', '화면', '시각', '스크린샷']),
+  e2e: Object.freeze(['playwright', 'e2e', 'click', 'navigate', 'automation', 'playwright', '클릭', '이동', '자동화']),
+  analysis: Object.freeze(['analysis', 'analyze', 'audit', 'compare', 'root cause', '분석', '검토', '비교', '원인']),
+  planning: Object.freeze(['plan', 'planning', 'strategy', 'design', '계획', '전략', '설계']),
+  reasoning: Object.freeze(['reason', 'reasoning', 'think', 'critique', '추론', '사고', '비평']),
+  security: Object.freeze(['security', 'risk', 'threat', 'vulnerability', '보안', '위험', '취약점']),
+  review: Object.freeze(['review', 'reviewer', 'inspect', '리뷰', '검수']),
+});
+
+export const SERVER_EXPLICIT_KEYWORDS = Object.freeze({
+  context7: Object.freeze(['context7']),
+  'brave-search': Object.freeze(['brave', 'brave-search']),
+  exa: Object.freeze(['exa']),
+  tavily: Object.freeze(['tavily']),
+  playwright: Object.freeze(['playwright']),
+  'sequential-thinking': Object.freeze(['sequential-thinking', 'sequential thinking']),
+});
+
+export function uniqueStrings(values = []) {
+  return [...new Set(
+    values
+      .filter((value) => typeof value === 'string' && value.trim())
+      .map((value) => value.trim()),
+  )];
+}
+
+export function inferDomainTagsFromText(text = '') {
+  if (typeof text !== 'string' || !text.trim()) return [];
+  const normalized = text.toLocaleLowerCase();
+  const matched = [];
+
+  for (const [tag, keywords] of Object.entries(DOMAIN_TAG_KEYWORDS)) {
+    if (keywords.some((keyword) => normalized.includes(String(keyword).toLocaleLowerCase()))) {
+      matched.push(tag);
+    }
+  }
+
+  return uniqueStrings(matched);
+}
+
+export function getDefaultServerMetadata(serverName = '') {
+  const toolCount = MCP_SERVER_TOOL_CATALOG[serverName]?.length || 0;
+  const domainTags = uniqueStrings([
+    ...(MCP_SERVER_DOMAIN_TAGS[serverName] || []),
+    ...inferDomainTagsFromText(serverName),
+  ]);
+
+  return {
+    tool_count: toolCount,
+    domain_tags: domainTags,
+  };
+}
+
+export function normalizeServerMetadata(serverName = '', metadata = {}) {
+  const fallback = getDefaultServerMetadata(serverName);
+  const toolCount = Number.isFinite(metadata.tool_count)
+    ? Math.max(0, Math.trunc(metadata.tool_count))
+    : fallback.tool_count;
+  const domainTags = uniqueStrings([
+    ...fallback.domain_tags,
+    ...(Array.isArray(metadata.domain_tags) ? metadata.domain_tags : []),
+    ...inferDomainTagsFromText([
+      serverName,
+      typeof metadata.command === 'string' ? metadata.command : '',
+      typeof metadata.url === 'string' ? metadata.url : '',
+      ...(Array.isArray(metadata.args) ? metadata.args : []),
+      ...(metadata.env && typeof metadata.env === 'object' ? Object.keys(metadata.env) : []),
+    ].join(' ')),
+  ]);
+
+  return {
+    tool_count: toolCount,
+    domain_tags: domainTags,
+  };
+}

package/scripts/mcp-check.mjs

@@ -1,88 +1,126 @@
-#!/usr/bin/env node
-// MCP 인벤토리 — 백그라운드 비동기 실행
-// Codex/Gemini의 MCP 서버 상태를 캐싱하여 tfx-route.sh가 동적 힌트 생성에 사용
-//
-// 출력: ~/.claude/cache/mcp-inventory.json
-// 사용: tfx-route.sh의 get_mcp_hint()에서 읽음
-
-import { readFileSync, writeFileSync, mkdirSync, existsSync } from "fs";
-import { join } from "path";
-import { homedir } from "os";
-import { execSync } from "child_process";
-
-const CACHE_DIR = join(homedir(), ".claude", "cache");
-const CACHE_FILE = join(CACHE_DIR, "mcp-inventory.json");
-
-function getCodexMcp() {
-  try {
-    const output = execSync("codex mcp list", {
-      encoding: "utf8",
-      timeout: 15000,
-      stdio: ["pipe", "pipe", "ignore"], // stderr 무시 (Windows 호환)
-    });
-    // 테이블 파싱: 첫 줄 헤더, 이후 줄에서 Name과 Status 추출
-    const lines = output.trim().split(/\r?\n/).filter(l => l.trim());
-    if (lines.length < 2) return [];
-
-    const servers = [];
-    for (let i = 1; i < lines.length; i++) {
-      const cols = lines[i].split(/\s{2,}/);
-      if (cols.length >= 2) {
-        const name = cols[0].trim();
-        // Status는 마지막에서 2번째 컬럼 근처
-        const statusMatch = lines[i].match(/\b(enabled|disabled)\b/i);
-        const status = statusMatch ? statusMatch[1].toLowerCase() : "unknown";
-        if (name && !name.startsWith("-")) {
-          servers.push({ name, status });
-        }
-      }
-    }
-    return servers;
-  } catch {
-    return null; // codex 미설치 또는 타임아웃
-  }
-}
-
-function getGeminiMcp() {
-  try {
-    const settingsPath = join(homedir(), ".gemini", "settings.json");
-    if (!existsSync(settingsPath)) return null;
-
-    const settings = JSON.parse(readFileSync(settingsPath, "utf8"));
-    const mcpServers = settings.mcpServers || {};
-    return Object.keys(mcpServers).map(name => ({
-      name,
-      status: "configured",
-    }));
-  } catch {
-    return null;
-  }
-}
-
-function main() {
-  if (!existsSync(CACHE_DIR)) mkdirSync(CACHE_DIR, { recursive: true });
-
-  const inventory = {
-    timestamp: new Date().toISOString(),
-    codex: { available: false, servers: [] },
-    gemini: { available: false, servers: [] },
-  };
-
-  // Codex MCP
-  const codexServers = getCodexMcp();
-  if (codexServers !== null) {
-    inventory.codex.available = true;
-    inventory.codex.servers = codexServers;
-  }
-
-  // Gemini MCP
-  const geminiServers = getGeminiMcp();
-  if (geminiServers !== null) {
-    inventory.gemini.available = true;
-    inventory.gemini.servers = geminiServers;
-  }
-
-  writeFileSync(CACHE_FILE, JSON.stringify(inventory, null, 2));
-}
-
-main();
+#!/usr/bin/env node
+// MCP inventory cache for dynamic MCP filtering.
+
+import { execSync } from 'node:child_process';
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+import { 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'];
+  for (const key of directKeys) {
+    if (Array.isArray(config[key])) return config[key].length;
+  }
+
+  if (Array.isArray(config.excludeTools)) {
+    return Math.max(0, fallbackToolCount - config.excludeTools.length);
+  }
+
+  return fallbackToolCount;
+}
+
+export function createServerRecord(name, status, config = {}) {
+  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)
+    ? config.domain_tags
+    : Array.isArray(config.domainTags)
+      ? config.domainTags
+      : [];
+
+  const metadata = normalizeServerMetadata(normalizedName, {
+    ...config,
+    tool_count: toolCount,
+    domain_tags: domainTags,
+  });
+
+  return {
+    name: normalizedName,
+    status,
+    tool_count: metadata.tool_count,
+    domain_tags: metadata.domain_tags,
+  };
+}
+
+export function getCodexMcp() {
+  try {
+    const output = execSync('codex mcp list', {
+      encoding: 'utf8',
+      timeout: 15000,
+      stdio: ['pipe', 'pipe', 'ignore'],
+    });
+    const lines = output.trim().split(/\r?\n/).filter((line) => line.trim());
+    if (lines.length < 2) return [];
+
+    const servers = [];
+    for (let i = 1; i < lines.length; i += 1) {
+      const cols = lines[i].split(/\s{2,}/);
+      if (cols.length < 2) continue;
+
+      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;
+      servers.push(createServerRecord(name, status));
+    }
+    return servers;
+  } catch {
+    return null;
+  }
+}
+
+export function getGeminiMcp() {
+  try {
+    const settingsPath = join(homedir(), '.gemini', 'settings.json');
+    if (!existsSync(settingsPath)) return null;
+
+    const settings = JSON.parse(readFileSync(settingsPath, 'utf8'));
+    const mcpServers = settings.mcpServers || {};
+    return Object.entries(mcpServers).map(([name, config]) => createServerRecord(name, 'configured', config || {}));
+  } catch {
+    return null;
+  }
+}
+
+export function buildInventory() {
+  const inventory = {
+    timestamp: new Date().toISOString(),
+    codex: { available: false, servers: [] },
+    gemini: { available: false, servers: [] },
+  };
+
+  const codexServers = getCodexMcp();
+  if (codexServers !== null) {
+    inventory.codex.available = true;
+    inventory.codex.servers = codexServers;
+  }
+
+  const geminiServers = getGeminiMcp();
+  if (geminiServers !== null) {
+    inventory.gemini.available = true;
+    inventory.gemini.servers = geminiServers;
+  }
+
+  return inventory;
+}
+
+export function writeInventoryCache(inventory = buildInventory()) {
+  if (!existsSync(CACHE_DIR)) mkdirSync(CACHE_DIR, { recursive: true });
+  writeFileSync(CACHE_FILE, JSON.stringify(inventory, null, 2));
+  return inventory;
+}
+
+export function main() {
+  writeInventoryCache();
+}
+
+if (process.argv[1] && fileURLToPath(import.meta.url) === process.argv[1]) {
+  main();
+}

package/scripts/setup.mjs

@@ -57,16 +57,21 @@ const SYNC_MAP = [
     dst: join(CLAUDE_DIR, "scripts", "tfx-route-worker.mjs"),
     label: "tfx-route-worker.mjs",
   },
-  {
-    src: join(PLUGIN_ROOT, "hub", "workers", "codex-mcp.mjs"),
-    dst: join(CLAUDE_DIR, "scripts", "hub", "workers", "codex-mcp.mjs"),
-    label: "hub/workers/codex-mcp.mjs",
-  },
-  {
-    src: join(PLUGIN_ROOT, "hub", "workers", "interface.mjs"),
-    dst: join(CLAUDE_DIR, "scripts", "hub", "workers", "interface.mjs"),
-    label: "hub/workers/interface.mjs",
-  },
+  {
+    src: join(PLUGIN_ROOT, "hub", "workers", "codex-mcp.mjs"),
+    dst: join(CLAUDE_DIR, "scripts", "hub", "workers", "codex-mcp.mjs"),
+    label: "hub/workers/codex-mcp.mjs",
+  },
+  {
+    src: join(PLUGIN_ROOT, "hub", "workers", "delegator-mcp.mjs"),
+    dst: join(CLAUDE_DIR, "scripts", "hub", "workers", "delegator-mcp.mjs"),
+    label: "hub/workers/delegator-mcp.mjs",
+  },
+  {
+    src: join(PLUGIN_ROOT, "hub", "workers", "interface.mjs"),
+    dst: join(CLAUDE_DIR, "scripts", "hub", "workers", "interface.mjs"),
+    label: "hub/workers/interface.mjs",
+  },
   {
     src: join(PLUGIN_ROOT, "hub", "workers", "gemini-worker.mjs"),
     dst: join(CLAUDE_DIR, "scripts", "hub", "workers", "gemini-worker.mjs"),

package/scripts/test-tfx-route-no-claude-native.mjs

@@ -11,7 +11,16 @@ const PROJECT_ROOT = resolve(SCRIPT_DIR, "..");
 function runBash(command) {
   return spawnSync("bash", ["-lc", command], {
     cwd: PROJECT_ROOT,
-    encoding: "utf8"
+    encoding: "utf8",
+    env: {
+      ...process.env,
+      TFX_TEAM_NAME: '',
+      TFX_TEAM_TASK_ID: '',
+      TFX_TEAM_AGENT_NAME: '',
+      TFX_TEAM_LEAD_NAME: '',
+      TFX_HUB_URL: '',
+      TMUX: '',
+    }
   });
 }
 
@@ -46,4 +55,3 @@ test("TFX_NO_CLAUDE_NATIVE는 0/1 값만 허용한다", () => {
   assert.notEqual(result.status, 0, out(result));
   assert.match(out(result), /0 또는 1/, out(result));
 });
-