@triflux/remote 10.25.1 → 10.26.0

package/scripts/lib/mcp-gateway-health-check.mjs

@@ -0,0 +1,159 @@
+// scripts/lib/mcp-gateway-health-check.mjs
+//
+// `~/.local/state/triflux/mcp-gateway.out.log` 파싱 헬퍼.
+// install-mcp-gateway-startup.mjs 가 LaunchAgent/systemd 로 띄운 gateway daemon
+// (mcp-gateway-start.mjs) 의 stdout 로그에서 다음 신호를 추출한다.
+//
+//   [WARN] <server> skipped — missing env: <KEY>   → missing-env finding
+//   [START] <server> on :<port>                    → started
+//   [SKIP]  <server> already running on :<port>    → started (preExisting)
+//   [SKIP]  <server> — manifest에서 비활성         → manifest-disabled skip
+//
+// 호출자는 `findings` 만 보고 doctor 진단을 출력할 수 있다.
+// log 파일이 없으면 `available: false` 로 반환하므로, gateway 미설치 환경에서는
+// 침묵한다 (false-positive 방지).
+
+import { readFileSync, statSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+
+const DEFAULT_LOG_PATH = join(
+  homedir(),
+  ".local",
+  "state",
+  "triflux",
+  "mcp-gateway.out.log",
+);
+
+// producer (scripts/mcp-gateway-start.mjs:146) 가 missing env 를 `missing.join(", ")`
+// 로 출력하므로 detail 은 공백 포함 다중 키 (예: "JIRA_API_TOKEN, JIRA_EMAIL, JIRA_INSTANCE_URL")
+// 일 수 있다. line 끝까지 캡처한다.
+const MISSING_ENV_RE = /^\[WARN\]\s+(\S+)\s+skipped\s+—\s+missing env:\s+(.+)$/;
+const START_RE = /^\[START\]\s+(\S+)\s+on\s+:(\d+)$/;
+const SKIP_RUNNING_RE = /^\[SKIP\]\s+(\S+)\s+already running on\s+:(\d+)$/;
+const SKIP_DISABLED_RE = /^\[SKIP\]\s+(\S+)\s+—\s+manifest에서 비활성$/;
+
+export function checkMcpGatewayHealth({
+  fs = { readFileSync, statSync },
+  logPath = DEFAULT_LOG_PATH,
+} = {}) {
+  try {
+    fs.statSync(logPath);
+  } catch {
+    return {
+      available: false,
+      logPath,
+      findings: [],
+      started: [],
+      skipped: [],
+    };
+  }
+
+  let text;
+  try {
+    text = fs.readFileSync(logPath, "utf8");
+  } catch (error) {
+    return {
+      available: true,
+      logPath,
+      findings: [
+        {
+          server: null,
+          reason: "log-read-error",
+          detail: error?.message || String(error),
+        },
+      ],
+      started: [],
+      skipped: [],
+    };
+  }
+
+  // log 는 append-only 라 옛 [WARN] 라인 뒤에 새 [START] 라인이 올 수 있다.
+  // server 별 마지막 이벤트가 현재 상태이므로 그것만 finding 으로 환원한다.
+  // (예: BRAVE_API_KEY missing 으로 한 번 skip → secrets 추가 후 restart 로 start)
+  const lastEvent = new Map();
+
+  for (const rawLine of text.split("\n")) {
+    const line = rawLine.trim();
+    if (!line) continue;
+
+    let m;
+    if ((m = MISSING_ENV_RE.exec(line))) {
+      lastEvent.set(m[1], {
+        type: "missing-env",
+        detail: m[2],
+      });
+      continue;
+    }
+    if ((m = START_RE.exec(line))) {
+      lastEvent.set(m[1], {
+        type: "started",
+        port: Number(m[2]),
+        preExisting: false,
+      });
+      continue;
+    }
+    if ((m = SKIP_RUNNING_RE.exec(line))) {
+      lastEvent.set(m[1], {
+        type: "started",
+        port: Number(m[2]),
+        preExisting: true,
+      });
+      continue;
+    }
+    if ((m = SKIP_DISABLED_RE.exec(line))) {
+      lastEvent.set(m[1], {
+        type: "manifest-disabled",
+      });
+    }
+  }
+
+  const findings = [];
+  const started = [];
+  const skipped = [];
+  for (const [server, ev] of lastEvent) {
+    if (ev.type === "missing-env") {
+      findings.push({ server, reason: "missing-env", detail: ev.detail });
+    } else if (ev.type === "started") {
+      started.push({ server, port: ev.port, preExisting: ev.preExisting });
+    } else if (ev.type === "manifest-disabled") {
+      skipped.push({ server, reason: "manifest-disabled" });
+    }
+  }
+
+  return {
+    available: true,
+    logPath,
+    findings,
+    started,
+    skipped,
+  };
+}
+
+export function summarizeMcpGatewayHealth(result) {
+  if (!result?.available) {
+    return {
+      level: "skip",
+      message: "mcp-gateway log 없음 (gateway 미설치 또는 미실행)",
+    };
+  }
+  if (result.findings.length === 0) {
+    return {
+      level: "ok",
+      message: `mcp-gateway healthy (${result.started.length}개 server up)`,
+    };
+  }
+  const missingEnv = result.findings.filter((f) => f.reason === "missing-env");
+  if (missingEnv.length > 0) {
+    const list = missingEnv.map((f) => `${f.server} (${f.detail})`).join(", ");
+    return {
+      level: "warn",
+      message: `${missingEnv.length}개 MCP 서버가 missing env 로 skip: ${list}`,
+      fix: "secrets 를 ~/.config/triflux/secrets.env 에 추가하고 `launchctl kickstart -k gui/$(id -u)/com.tellang.mcp-gateway` (macOS) 또는 `systemctl --user restart mcp-gateway` (linux)",
+    };
+  }
+  return {
+    level: "warn",
+    message: `${result.findings.length}개 gateway 이슈`,
+  };
+}

package/scripts/lib/mcp-gateway-wrapper-check.mjs

@@ -0,0 +1,35 @@
+import { readFile } from "node:fs/promises";
+import os from "node:os";
+import path from "node:path";
+
+export async function checkWrapperSourcing({
+  wrapperPath = path.join(
+    os.homedir(),
+    ".local",
+    "bin",
+    "mcp-gateway-wrapper.sh",
+  ),
+  marker = "secrets.env",
+} = {}) {
+  let text;
+  try {
+    text = await readFile(wrapperPath, "utf8");
+  } catch (error) {
+    const result = { status: "missing", wrapperPath };
+    if (error?.code !== "ENOENT") {
+      result.message = `wrapper read failed: ${error?.message || String(error)}`;
+    }
+    return result;
+  }
+
+  if (text.includes(marker)) {
+    return { status: "ok", wrapperPath };
+  }
+
+  return {
+    status: "warn",
+    wrapperPath,
+    message: "wrapper exists but does not source secrets.env",
+    suggestedFix: "Re-run: node scripts/install-mcp-gateway-startup.mjs",
+  };
+}

package/scripts/lib/psmux-info.mjs

@@ -12,14 +12,14 @@ export const PSMUX_OPTIONAL_COMMANDS = ["detach-client"];
 
 // Windows 패키지 매니저 — winget/scoop/choco 는 Windows 전용
 export const PSMUX_INSTALL_COMMANDS = [
-  "winget install marlocarlo.psmux",
+  "winget install psmux",
   "scoop install psmux",
   "choco install psmux",
   "cargo install psmux",
 ];
 
 export const PSMUX_UPDATE_COMMANDS = [
-  "winget upgrade marlocarlo.psmux",
+  "winget upgrade psmux",
   "scoop update psmux",
   "choco upgrade psmux",
   "cargo install psmux --force",
@@ -42,14 +42,15 @@ export const PSMUX_INSTALL_COMMANDS_LINUX = ["cargo install psmux"];
 export const PSMUX_UPDATE_COMMANDS_LINUX = ["cargo install psmux --force"];
 
 // PR #258 OS-primary 분기 정책: macOS/Linux 는 tmux 가 POSIX 표준 primary,
-// psmux 는 선택형. native teams fallback (tmux 또는 child process spawn) 으로 동작 가능.
+// psmux 는 선택형이다. 따라서 macOS/Linux 에서 "psmux 미설치"는 fallback 사유가
+// 아니며, tmux 까지 없을 때만 native/in-process fallback 을 고려한다.
 export const PSMUX_FALLBACK_NOTE_DARWIN =
   "macOS 에서는 tmux 가 표준 멀티플렉서이며, " +
-  "triflux 는 psmux 없이도 native teams fallback 으로 멀티모델 병렬 실행을 지원합니다.";
+  "psmux 미설치는 fallback 사유가 아닙니다. tmux 도 없을 때만 in-process/native fallback 을 사용합니다.";
 
 export const PSMUX_FALLBACK_NOTE_LINUX =
   "Linux 에서는 tmux 가 표준 멀티플렉서이며, " +
-  "triflux 는 psmux 없이도 native teams fallback 으로 멀티모델 병렬 실행을 지원합니다.";
+  "psmux 미설치는 fallback 사유가 아닙니다. tmux 도 없을 때만 in-process/native fallback 을 사용합니다.";
 
 export function getPsmuxInstallCommandsFor(platform = process.platform) {
   if (platform === "darwin") return PSMUX_INSTALL_COMMANDS_DARWIN;
@@ -177,3 +178,47 @@ 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: [],
+    };
+  } catch (error) {
+    return {
+      ok: false,
+      installed: false,
+      kind: "tmux",
+      version: null,
+      recommendedVersion: null,
+      recommended: false,
+      missingCommands: ["tmux"],
+      missingOptionalCommands: [],
+      error: error?.message || String(error),
+    };
+  }
+}