@triflux/core 10.50.2 → 10.51.0

package/scripts/lib/mcp-filter.mjs

@@ -15,10 +15,6 @@ import {
   uniqueStrings,
 } from "./mcp-server-catalog.mjs";
 
-export const KNOWN_MCP_SERVERS = Object.freeze(
-  Object.keys(MCP_SERVER_TOOL_CATALOG),
-);
-
 const SEARCH_INTENT_PATTERNS = Object.freeze([
   /\b(search|web|browse|look ?up|find|latest|recent|news|current|today|release(?: note)?s?|changelog|announcement|pricing|status|verify|fact[- ]?check)\b/i,
   /(검색|웹|브라우즈|찾아|조회|최신|최근|뉴스|현재|오늘|릴리즈|배포|변경사항|공지|가격|상태|검증)/u,
@@ -145,7 +141,7 @@ const PROFILE_DEFINITIONS = Object.freeze({
  * 파이프라인 단계별 MCP 서버/도구 제한 (post-filter).
  * role-based 프로필 위에 추가 적용. 빈 배열 = 전체 차단, 미정의 = 제한 없음.
  */
-export const PHASE_OVERRIDES = Object.freeze({
+const PHASE_OVERRIDES = Object.freeze({
   plan: Object.freeze({
     description: "계획 단계: 읽기 전용 탐색만 허용",
     allowedServers: Object.freeze(["context7"]),
@@ -166,7 +162,7 @@ export const PHASE_OVERRIDES = Object.freeze({
   }),
 });
 
-export const LEGACY_PROFILE_ALIASES = Object.freeze({
+const LEGACY_PROFILE_ALIASES = Object.freeze({
   implement: "executor",
   analyze: "analyze",
   review: "reviewer",
@@ -257,30 +253,51 @@ function loadInventory(inventoryFile = "") {
   }
 }
 
+function availableServersFromInventory(inventory, cliType) {
+  const servers = inventory?.[cliType]?.servers || [];
+  return uniqueStrings(
+    servers
+      .filter((server) => ["enabled", "configured"].includes(server.status))
+      .map((server) => server.name),
+  );
+}
+
+function codexServersFromConfig(configFile) {
+  if (!configFile) return [];
+  try {
+    return uniqueStrings(
+      readFileSync(configFile, "utf8")
+        .split(/\r?\n/)
+        .map((line) => /^\[mcp_servers\.([^\].]+)\]$/.exec(line)?.[1])
+        .filter(Boolean),
+    ).sort();
+  } catch {
+    return [];
+  }
+}
+
 function buildInventoryIndex(inventory = null) {
   const index = new Map();
   if (!inventory || typeof inventory !== "object") return index;
 
-  for (const client of ["codex", "gemini"]) {
-    const servers = Array.isArray(inventory[client]?.servers)
-      ? inventory[client].servers
-      : [];
-    for (const server of servers) {
-      if (!server || typeof server.name !== "string" || !server.name.trim())
-        continue;
-      const name = server.name.trim();
-      const previous = index.get(name) || {};
-      index.set(name, {
-        ...previous,
-        tool_count: Number.isFinite(server.tool_count)
-          ? Math.max(previous.tool_count ?? 0, Math.trunc(server.tool_count))
-          : previous.tool_count,
-        domain_tags: uniqueStrings([
-          ...(Array.isArray(previous.domain_tags) ? previous.domain_tags : []),
-          ...(Array.isArray(server.domain_tags) ? server.domain_tags : []),
-        ]),
-      });
-    }
+  const servers = Array.isArray(inventory.codex?.servers)
+    ? inventory.codex.servers
+    : [];
+  for (const server of servers) {
+    if (!server || typeof server.name !== "string" || !server.name.trim())
+      continue;
+    const name = server.name.trim();
+    const previous = index.get(name) || {};
+    index.set(name, {
+      ...previous,
+      tool_count: Number.isFinite(server.tool_count)
+        ? Math.max(previous.tool_count ?? 0, Math.trunc(server.tool_count))
+        : previous.tool_count,
+      domain_tags: uniqueStrings([
+        ...(Array.isArray(previous.domain_tags) ? previous.domain_tags : []),
+        ...(Array.isArray(server.domain_tags) ? server.domain_tags : []),
+      ]),
+    });
   }
 
   return index;
@@ -498,7 +515,7 @@ export function resolveMcpProfile(agentType = "", requestedProfile = "auto") {
   return normalized === "auto" ? resolveAutoProfile(agentType) : normalized;
 }
 
-export function parseAvailableServers(rawAvailableServers = "") {
+function parseAvailableServers(rawAvailableServers = "") {
   if (Array.isArray(rawAvailableServers))
     return uniqueStrings(rawAvailableServers);
   if (typeof rawAvailableServers !== "string" || !rawAvailableServers.trim())
@@ -554,15 +571,21 @@ function applyManifestFilter(servers) {
   return servers.filter((s) => enabled.has(s));
 }
 
-export function resolveAllowedServers(options = {}) {
+function resolveAllowedServers(options = {}) {
   const resolvedProfile = resolveMcpProfile(
     options.agentType,
     options.requestedProfile,
   );
   const profile = getProfileDefinition(resolvedProfile);
   const availableServers = parseAvailableServers(options.availableServers);
-  const inventory = options.inventory || loadInventory(options.inventoryFile);
-  const inventoryIndex = buildInventoryIndex(inventory);
+  const inventory =
+    options.inventory !== undefined
+      ? options.inventory
+      : loadInventory(options.inventoryFile);
+  const inventoryIndex =
+    options.inventoryIndex instanceof Map
+      ? options.inventoryIndex
+      : buildInventoryIndex(inventory);
   const baseServers = availableServers.length
     ? profile.allowedServers.filter((server) =>
         availableServers.includes(server),
@@ -585,8 +608,14 @@ export function buildPromptHint(options = {}) {
   );
   if (resolvedProfile === "none") return "";
 
-  const inventory = options.inventory || loadInventory(options.inventoryFile);
-  const inventoryIndex = buildInventoryIndex(inventory);
+  const inventory =
+    options.inventory !== undefined
+      ? options.inventory
+      : loadInventory(options.inventoryFile);
+  const inventoryIndex =
+    options.inventoryIndex instanceof Map
+      ? options.inventoryIndex
+      : buildInventoryIndex(inventory);
   const allowedServers = resolveAllowedServers({
     ...options,
     inventory,
@@ -636,16 +665,7 @@ export function buildPromptHint(options = {}) {
     .join(" ");
 }
 
-export function getGeminiAllowedServers(options = {}) {
-  return resolveAllowedServers(options);
-}
-
 export function getCodexMcpConfig(options = {}) {
-  const allowedServers = new Set(resolveAllowedServers(options));
-  const resolvedProfile = resolveMcpProfile(
-    options.agentType,
-    options.requestedProfile,
-  );
   // Codex에 실제 등록된 서버만 대상으로 config override 생성.
   // 미등록 서버에 enabled=false를 보내면 "invalid transport" 에러 발생.
   const registeredServers = parseAvailableServers(options.availableServers);
@@ -654,6 +674,11 @@ export function getCodexMcpConfig(options = {}) {
   if (registeredServers.length === 0) {
     return { mcp_servers: {} };
   }
+  const allowedServers = new Set(resolveAllowedServers(options));
+  const resolvedProfile = resolveMcpProfile(
+    options.agentType,
+    options.requestedProfile,
+  );
   const targetServers = registeredServers;
 
   if (resolvedProfile === "none") {
@@ -712,9 +737,27 @@ export function getCodexConfigOverrides(options = {}) {
 }
 
 export function buildMcpPolicy(options = {}) {
-  const inventory = options.inventory || loadInventory(options.inventoryFile);
+  const inventory =
+    options.inventory !== undefined
+      ? options.inventory
+      : loadInventory(options.inventoryFile);
   const inventoryIndex = buildInventoryIndex(inventory);
-  const resolvedOptions = { ...options, inventory, inventoryIndex };
+  let availableServers = options.availableServers;
+  if (availableServers === undefined) {
+    availableServers = availableServersFromInventory(
+      inventory,
+      options.cliType,
+    );
+    if (availableServers.length === 0 && options.cliType === "codex") {
+      availableServers = codexServersFromConfig(options.codexConfig);
+    }
+  }
+  const resolvedOptions = {
+    ...options,
+    availableServers,
+    inventory,
+    inventoryIndex,
+  };
   const resolvedProfile = resolveMcpProfile(
     options.agentType,
     options.requestedProfile,
@@ -730,6 +773,12 @@ export function buildMcpPolicy(options = {}) {
     allowedServers = allowedServers.filter((s) => !blocked.has(s));
   }
 
+  // 플러그인 서버는 transport 설정이 없어 CLI override를 받으면 부팅이 실패한다.
+  const codexOptions = {
+    ...resolvedOptions,
+    availableServers: codexServersFromConfig(options.codexConfig),
+  };
+
   return {
     requestedProfile:
       typeof options.requestedProfile === "string" && options.requestedProfile
@@ -739,9 +788,8 @@ export function buildMcpPolicy(options = {}) {
     resolvedPhase: phase || null,
     allowedServers,
     hint,
-    geminiAllowedServers: getGeminiAllowedServers(resolvedOptions),
-    codexConfig: getCodexMcpConfig(resolvedOptions),
-    codexConfigOverrides: getCodexConfigOverrides(resolvedOptions),
+    codexConfig: getCodexMcpConfig(codexOptions),
+    codexConfigOverrides: getCodexConfigOverrides(codexOptions),
   };
 }
 
@@ -753,25 +801,25 @@ function shellArray(name, values) {
   return `${name}=(${values.map((value) => shellEscape(value)).join(" ")})`;
 }
 
-export function toDelimited(policy) {
+function toDelimited(policy) {
   const RS = "\x1e";
   return [
     policy.requestedProfile,
     policy.resolvedProfile,
     policy.hint,
-    policy.geminiAllowedServers.join(","),
-    policy.codexConfigOverrides.flatMap((o) => ["-c", o]).join(","),
+    policy.allowedServers.join(","),
+    policy.codexConfigOverrides.flatMap((o) => ["-c", o]).join("\x1f"),
     JSON.stringify(policy.codexConfig),
     policy.resolvedPhase || "",
   ].join(RS);
 }
 
-export function toShellExports(policy) {
+function toShellExports(policy) {
   const lines = [
     `MCP_PROFILE_REQUESTED=${shellEscape(policy.requestedProfile)}`,
     `MCP_RESOLVED_PROFILE=${shellEscape(policy.resolvedProfile)}`,
     `MCP_HINT=${shellEscape(policy.hint)}`,
-    shellArray("GEMINI_ALLOWED_SERVERS", policy.geminiAllowedServers),
+    shellArray("ALLOWED_MCP_SERVERS", policy.allowedServers),
     shellArray(
       "CODEX_CONFIG_FLAGS",
       policy.codexConfigOverrides.flatMap((override) => ["-c", override]),
@@ -789,8 +837,10 @@ function parseCliArgs(argv) {
     command: "json",
     agentType: "",
     requestedProfile: "auto",
-    availableServers: [],
+    availableServers: undefined,
     inventoryFile: "",
+    cliType: "",
+    codexConfig: "",
     searchTool: "",
     taskText: "",
     workerIndex: undefined,
@@ -821,6 +871,12 @@ function parseCliArgs(argv) {
       case "--available":
         args.availableServers = parseAvailableServers(next());
         break;
+      case "--cli-type":
+        args.cliType = next();
+        break;
+      case "--codex-config":
+        args.codexConfig = next();
+        break;
       case "--inventory-file":
         args.inventoryFile = next();
         break;
@@ -844,7 +900,7 @@ function parseCliArgs(argv) {
   return args;
 }
 
-export async function runCli(argv = process.argv.slice(2)) {
+async function runCli(argv = process.argv.slice(2)) {
   let args;
   try {
     args = parseCliArgs(argv);

package/scripts/lib/mcp-health.mjs

@@ -224,7 +224,7 @@ export function parseMcpServersFromToml(content = "") {
   return servers;
 }
 
-export function readMcpServers(configPath = DEFAULT_CONFIG_PATH) {
+function readMcpServers(configPath = DEFAULT_CONFIG_PATH) {
   if (!existsSync(configPath)) return {};
   try {
     const content = readFileSync(configPath, "utf8");
@@ -754,7 +754,7 @@ function renderOutput(results, source, format) {
   return JSON.stringify({ source, healthy, dead, results }, null, 2);
 }
 
-export async function runCli(argv = process.argv.slice(2)) {
+async function runCli(argv = process.argv.slice(2)) {
   let args;
   try {
     args = parseCliArgs(argv);

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

@@ -296,7 +296,7 @@ export function uniqueStrings(values = []) {
   ];
 }
 
-export function inferDomainTagsFromText(text = "") {
+function inferDomainTagsFromText(text = "") {
   if (typeof text !== "string" || !text.trim()) return [];
   const normalized = text.toLocaleLowerCase();
   const matched = [];
@@ -314,7 +314,7 @@ export function inferDomainTagsFromText(text = "") {
   return uniqueStrings(matched);
 }
 
-export function getDefaultServerMetadata(serverName = "") {
+function getDefaultServerMetadata(serverName = "") {
   const toolCount = MCP_SERVER_TOOL_CATALOG[serverName]?.length || 0;
   const domainTags = uniqueStrings([
     ...(MCP_SERVER_DOMAIN_TAGS[serverName] || []),

package/scripts/lib/psmux-info.mjs

@@ -1,36 +1,36 @@
 import { execFileSync } from "node:child_process";
 
-export const PSMUX_RECOMMENDED_VERSION = "3.3.1";
-export const PSMUX_REQUIRED_COMMANDS = [
+const PSMUX_RECOMMENDED_VERSION = "3.3.1";
+const PSMUX_REQUIRED_COMMANDS = [
   "new-session",
   "attach-session",
   "kill-session",
   "capture-pane",
 ];
 
-export const PSMUX_OPTIONAL_COMMANDS = ["detach-client"];
+const PSMUX_OPTIONAL_COMMANDS = ["detach-client"];
 
 // Windows 전용 설치 명령
-export const PSMUX_INSTALL_COMMANDS = [
+const PSMUX_INSTALL_COMMANDS = [
   "winget install psmux",
   "scoop install psmux",
   "choco install psmux",
   "cargo install psmux",
 ];
 
-export const PSMUX_UPDATE_COMMANDS = [
+const PSMUX_UPDATE_COMMANDS = [
   "winget upgrade psmux",
   "scoop update psmux",
   "choco upgrade psmux",
   "cargo install psmux --force",
 ];
 
-export function getPsmuxInstallCommandsFor(platform = process.platform) {
+function getPsmuxInstallCommandsFor(platform = process.platform) {
   if (platform === "win32") return PSMUX_INSTALL_COMMANDS;
   return [platform === "darwin" ? "brew install tmux" : "apt install tmux"];
 }
 
-export function getPsmuxUpdateCommandsFor(platform = process.platform) {
+function getPsmuxUpdateCommandsFor(platform = process.platform) {
   if (platform === "win32") return PSMUX_UPDATE_COMMANDS;
   return [
     platform === "darwin"
@@ -39,7 +39,7 @@ export function getPsmuxUpdateCommandsFor(platform = process.platform) {
   ];
 }
 
-export function formatPsmuxCommandList(
+function formatPsmuxCommandList(
   commands = PSMUX_INSTALL_COMMANDS,
   indent = "",
 ) {
@@ -60,12 +60,12 @@ export function formatPsmuxUpdateGuidance(
   return formatPsmuxCommandList(getPsmuxUpdateCommandsFor(platform), indent);
 }
 
-export function parsePsmuxVersion(output = "") {
+function parsePsmuxVersion(output = "") {
   const match = String(output).match(/psmux\s+v?(\d+\.\d+\.\d+)/i);
   return match?.[1] || null;
 }
 
-export function compareSemver(a, b) {
+function compareSemver(a, b) {
   const left = String(a || "")
     .split(".")
     .map((part) => Number.parseInt(part, 10) || 0);
@@ -79,7 +79,7 @@ export function compareSemver(a, b) {
   return 0;
 }
 
-export function isRecommendedPsmuxVersion(version) {
+function isRecommendedPsmuxVersion(version) {
   if (!version) return false;
   return compareSemver(version, PSMUX_RECOMMENDED_VERSION) >= 0;
 }
@@ -143,51 +143,3 @@ export function probePsmuxSupport(options = {}) {
     };
   }
 }
-
-export function probePrimaryMultiplexerSupport(options = {}) {
-  const platform = options.platform || process.platform;
-  const execFileSyncFn = options.execFileSyncFn || execFileSync;
-
-  if (platform === "win32") {
-    return {
-      kind: "psmux",
-      ...probePsmuxSupport(options),
-    };
-  }
-
-  const bin = options.bin || "tmux";
-  try {
-    const versionOutput = execFileSyncFn(bin, ["-V"], {
-      encoding: "utf8",
-      timeout: 2000,
-      stdio: ["ignore", "pipe", "pipe"],
-      windowsHide: true,
-    });
-    return {
-      ok: true,
-      installed: true,
-      kind: "tmux",
-      version: String(versionOutput || "").trim() || null,
-      recommendedVersion: null,
-      recommended: true,
-      missingCommands: [],
-      missingOptionalCommands: [],
-      installHint: formatPsmuxInstallGuidance("  ", platform),
-      updateHint: formatPsmuxUpdateGuidance("  ", platform),
-    };
-  } catch (error) {
-    return {
-      ok: false,
-      installed: false,
-      kind: "tmux",
-      version: null,
-      recommendedVersion: null,
-      recommended: false,
-      missingCommands: ["tmux"],
-      missingOptionalCommands: [],
-      installHint: formatPsmuxInstallGuidance("  ", platform),
-      updateHint: formatPsmuxUpdateGuidance("  ", platform),
-      error: error?.message || String(error),
-    };
-  }
-}

package/scripts/lib/session-presence.mjs

@@ -139,7 +139,7 @@ function commandUsesClaudePrintMode(command) {
   );
 }
 
-function shouldSkipInteractiveRegistration(payload, seams = {}) {
+export function shouldSkipInteractiveRegistration(payload, seams = {}) {
   const declaredKind = String(
     payload?.sessionKind || payload?.session_kind || "",
   )