triflux 8.9.2 → 8.10.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "triflux",
-  "version": "8.9.2",
+  "version": "8.10.0",
   "description": "CLI-first multi-model orchestrator for Claude Code — route tasks to Codex, Gemini, and Claude",
   "type": "module",
   "bin": {

package/scripts/mcp-cleanup.ps1

@@ -0,0 +1,17 @@
+# mcp-cleanup.ps1 — Claude Code Stop hook: MCP 고아 프로세스 정리
+# Windows에서 Claude Code 세션 종료 시 남는 MCP 서버 고아 프로세스를 정리한다.
+# 원인: Claude Code가 stdio MCP 자식 프로세스 트리를 Windows에서 제대로 kill하지 못함
+#       (GitHub Issues #1935, #15211, #28126)
+$ErrorActionPreference = 'SilentlyContinue'
+
+# npx MCP servers (brave, notion, context7, exa, tavily, jira, playwright, etc.)
+# + oh-my-codex MCP servers (team/code-intel/memory/trace/state)
+# + omc bridge
+Get-CimInstance Win32_Process -Filter "Name='node.exe' OR Name='cmd.exe'" |
+  Where-Object { $_.CommandLine -match 'npx-cli|oh-my-codex[\\/]dist[\\/]mcp|omc.*bridge.*mcp-server' } |
+  ForEach-Object { taskkill /F /PID $_.ProcessId 2>$null }
+
+# serena (uvx) + python MCP orphans
+Get-CimInstance Win32_Process -Filter "Name='python.exe' OR Name='uvx.exe'" |
+  Where-Object { $_.CommandLine -match 'serena|uv[\\/](cache|python)' } |
+  ForEach-Object { taskkill /F /PID $_.ProcessId 2>$null }

package/scripts/setup.mjs

@@ -144,6 +144,11 @@ const SYNC_MAP = [
     dst: join(CLAUDE_DIR, "scripts", "hub", "workers", "factory.mjs"),
     label: "hub/workers/factory.mjs",
   },
+  {
+    src: join(PLUGIN_ROOT, "scripts", "mcp-cleanup.ps1"),
+    dst: join(CLAUDE_DIR, "scripts", "mcp-cleanup.ps1"),
+    label: "mcp-cleanup.ps1",
+  },
   {
     src: join(PLUGIN_ROOT, "hud", "hud-qos-status.mjs"),
     dst: join(CLAUDE_DIR, "hud", "hud-qos-status.mjs"),
@@ -580,6 +585,44 @@ function applyHooks(s) {
     changed = true;
   }
 
+  // ── Stop 훅: MCP 고아 프로세스 정리 (Windows 전용) ──
+  if (process.platform === "win32") {
+    if (!Array.isArray(s.hooks.Stop)) s.hooks.Stop = [];
+
+    const cleanupScriptPath = join(CLAUDE_DIR, "scripts", "mcp-cleanup.ps1").replace(/\\/g, "/");
+    const hasCleanupHook = s.hooks.Stop.some((entry) =>
+      Array.isArray(entry.hooks) &&
+      entry.hooks.some((h) => typeof h.command === "string" && h.command.includes("mcp-cleanup")),
+    );
+
+    if (!hasCleanupHook && existsSync(cleanupScriptPath.replace(/\//g, "\\"))) {
+      // 기존 Stop 엔트리가 있으면 거기에 추가, 없으면 새 엔트리 생성
+      const existingEntry = s.hooks.Stop.find((entry) => entry.matcher === "*" && Array.isArray(entry.hooks));
+      const cleanupHook = {
+        type: "command",
+        command: `powershell -NoProfile -WindowStyle Hidden -ExecutionPolicy Bypass -File "${cleanupScriptPath}"`,
+        timeout: 8,
+      };
+
+      if (existingEntry) {
+        existingEntry.hooks.push(cleanupHook);
+      } else {
+        s.hooks.Stop.push({ matcher: "*", hooks: [cleanupHook] });
+      }
+      changed = true;
+    } else if (hasCleanupHook) {
+      for (const entry of s.hooks.Stop) {
+        if (!Array.isArray(entry.hooks)) continue;
+        for (const h of entry.hooks) {
+          if (typeof h.command === "string" && h.command.includes("mcp-cleanup") && !h.command.includes(cleanupScriptPath)) {
+            h.command = `powershell -NoProfile -WindowStyle Hidden -ExecutionPolicy Bypass -File "${cleanupScriptPath}"`;
+            changed = true;
+          }
+        }
+      }
+    }
+  }
+
   // ── PreToolUse 훅: headless-guard (auto-route) ──
   if (!Array.isArray(s.hooks.PreToolUse)) s.hooks.PreToolUse = [];
 

package/skills/tfx-remote-setup/SKILL.md

@@ -337,7 +337,49 @@ options:
 
 저장 후 결과 보고.
 
-**2-8. 후속 작업**
+**2-8. MCP 고아 프로세스 정리 훅 배포 (Windows 원격 호스트)**
+
+원격 호스트가 Windows인 경우, MCP 고아 프로세스 정리 훅을 자동 배포한다.
+Claude Code 세션 종료 시 MCP 서버 프로세스가 정리되지 않는 Windows 고유 버그 대응.
+(GitHub Issues #1935, #15211, #28126)
+
+```bash
+# mcp-cleanup.ps1 배포
+scp "$(npm root -g)/triflux/scripts/mcp-cleanup.ps1" {host}:~/.claude/scripts/mcp-cleanup.ps1
+```
+
+배포 후 원격 호스트의 `~/.claude/settings.json`에 Stop 훅을 등록한다:
+
+```bash
+ssh {host} "node -e \"
+  const fs = require('fs');
+  const p = require('path').join(require('os').homedir(), '.claude', 'settings.json');
+  const s = JSON.parse(fs.readFileSync(p, 'utf8'));
+  if (!s.hooks) s.hooks = {};
+  if (!Array.isArray(s.hooks.Stop)) s.hooks.Stop = [];
+  const has = s.hooks.Stop.some(e => e.hooks?.some(h => h.command?.includes('mcp-cleanup')));
+  if (!has) {
+    const script = require('path').join(require('os').homedir(), '.claude/scripts/mcp-cleanup.ps1').replace(/\\\\\\\\/g, '/');
+    const entry = s.hooks.Stop.find(e => e.matcher === '*' && Array.isArray(e.hooks));
+    const hook = { type: 'command', command: 'powershell -NoProfile -WindowStyle Hidden -ExecutionPolicy Bypass -File \\\"' + script + '\\\"', timeout: 8 };
+    if (entry) entry.hooks.push(hook); else s.hooks.Stop.push({ matcher: '*', hooks: [hook] });
+    fs.writeFileSync(p, JSON.stringify(s, null, 2) + '\\n');
+    console.log('mcp-cleanup hook registered');
+  } else { console.log('mcp-cleanup hook already exists'); }
+\""
+```
+
+macOS/Linux 원격 호스트에서는 이 단계를 건너뛴다 (PGID 기반 kill이 정상 동작).
+
+프로브 결과에서 OS를 확인하여 자동 판단:
+- Windows → 배포 실행
+- macOS/Linux → 건너뛰기 (표시만)
+
+```
+"{host}는 Windows입니다. MCP 고아 프로세스 정리 훅을 배포합니다."
+```
+
+**2-9. 후속 작업**
 
 ```
 question: "호스트가 등록되었습니다. 추가 작업이 있습니까?"