triflux 10.19.0 → 10.20.0

package/.claude-plugin/marketplace.json

@@ -0,0 +1,34 @@
+{
+  "$schema": "https://anthropic.com/claude-code/marketplace.schema.json",
+  "name": "triflux",
+  "description": "CLI-first multi-model orchestrator — Codex/Gemini/Claude routing with DAG execution, auto-triage, and cost optimization",
+  "owner": {
+    "name": "tellang"
+  },
+  "plugins": [
+    {
+      "name": "triflux",
+      "description": "Tri-CLI orchestrator for Claude Code. Routes tasks across Claude + Codex + Gemini with consensus intelligence, natural language routing, 42 skills, and cross-model review.",
+      "version": "10.20.0",
+      "author": {
+        "name": "tellang"
+      },
+      "source": {
+        "source": "npm",
+        "package": "triflux"
+      },
+      "category": "productivity",
+      "homepage": "https://github.com/tellang/triflux",
+      "tags": [
+        "multi-model",
+        "codex",
+        "gemini",
+        "cli-routing",
+        "orchestration",
+        "cost-optimization",
+        "dag-execution"
+      ]
+    }
+  ],
+  "version": "10.20.0"
+}

package/.claude-plugin/plugin.json

@@ -0,0 +1,22 @@
+{
+  "name": "triflux",
+  "version": "10.20.0",
+  "description": "CLI-first multi-model orchestrator for Claude Code — route tasks to Codex, Gemini, and Claude",
+  "author": {
+    "name": "tellang"
+  },
+  "repository": "https://github.com/tellang/triflux",
+  "homepage": "https://github.com/tellang/triflux",
+  "license": "MIT",
+  "keywords": [
+    "claude-code",
+    "plugin",
+    "codex",
+    "gemini",
+    "cli-routing",
+    "orchestration",
+    "multi-model"
+  ],
+  "skills": "./skills/",
+  "hooks": "./hooks/hooks.json"
+}

package/config/mcp-registry.json

@@ -0,0 +1,44 @@
+{
+  "$schema": "mcp-registry-schema",
+  "version": 1,
+  "description": "MCP 서버 중앙 레지스트리 — 진실의 원천",
+  "defaults": {
+    "transport": "hub-url",
+    "hub_base": "http://127.0.0.1:27888"
+  },
+  "policy_notes": {
+    "transport": "Server transport accepts \"hub-url\" for the existing triflux Hub URL flow or \"http\" for direct Streamable HTTP MCP endpoints. Direct stdio registration via command/args is intentionally unsupported.",
+    "headers": "Optional headers are allowed only for HTTP-compatible transports. Each header value must be a descriptor: {\"value\":\"literal\"} for non-secret static values, {\"env\":\"ENV_VAR_NAME\"} for secrets resolved at sync/runtime, or {\"env\":\"ENV_VAR_NAME\",\"prefix\":\"Bearer \"} for common authorization formats.",
+    "secret_safety": "Resolved secret values must not be written back to this registry file. Missing env vars warn during sync and do not emit empty secret headers.",
+    "sync_denylist": "Array of client:server strings skipped by proactive registry sync, for example gemini:tfx-hub."
+  },
+  "servers": {
+    "tfx-hub": {
+      "transport": "hub-url",
+      "url": "http://127.0.0.1:27888/mcp",
+      "safe": true,
+      "targets": ["claude", "gemini", "codex"],
+      "description": "triflux Hub MCP 서버"
+    },
+    "context7": {
+      "transport": "http",
+      "url": "https://mcp.context7.com/mcp",
+      "safe": true,
+      "targets": ["claude", "gemini", "codex"],
+      "description": "Upstash Context7 — 라이브러리 문서/코드 컨텍스트 (HTTP MCP, API key 불필요)"
+    }
+  },
+  "policies": {
+    "stdio_action": "replace-with-hub",
+    "unknown_server_action": "warn",
+    "sync_denylist": [],
+    "watched_paths": [
+      "~/.gemini/settings.json",
+      "~/.codex/config.toml",
+      "~/.claude/settings.json",
+      "~/.claude/settings.local.json",
+      ".claude/mcp.json",
+      ".mcp.json"
+    ]
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "triflux",
-  "version": "10.19.0",
+  "version": "10.20.0",
   "description": "CLI-first multi-model orchestrator for Claude Code — route tasks to Codex, Gemini, and Claude",
   "type": "module",
   "bin": {
@@ -13,29 +13,81 @@
     "tfx-doctor-tui": "bin/tfx-doctor-tui.mjs",
     "tfx-setup-tui": "bin/tfx-setup-tui.mjs"
   },
-  "engines": {
-    "node": ">=18.0.0"
-  },
-  "dependencies": {
-    "@triflux/core": "10.0.1",
-    "@triflux/remote": "^10.0.0-alpha.1"
-  },
   "files": [
     "bin",
+    "tui",
+    "hub",
+    "config",
     "skills",
     "!skills/tfx-workspace",
+    "!**/failure-reports",
+    "scripts",
     "hooks",
     "hud",
-    "scripts",
-    "hub",
     "mesh",
-    "references",
-    "!references/codex-snapshots",
-    "!references/gemini-snapshots",
-    "CLAUDE.md",
+    ".claude-plugin",
     "README.md",
+    "README.ko.md",
     "LICENSE"
   ],
+  "workspaces": [
+    "packages/core",
+    "packages/remote",
+    "packages/triflux"
+  ],
+  "scripts": {
+    "pack": "node scripts/pack.mjs all",
+    "pack:core": "node scripts/pack.mjs core",
+    "pack:remote": "node scripts/pack.mjs remote",
+    "setup": "node scripts/setup.mjs",
+    "preinstall": "node scripts/preinstall.mjs",
+    "postinstall": "node scripts/setup.mjs",
+    "snapshot:codex": "node scripts/snapshot-codex-state.mjs",
+    "snapshot:gemini": "node scripts/snapshot-gemini-state.mjs",
+    "snapshot:all": "npm run snapshot:codex && npm run snapshot:gemini",
+    "lint": "biome check bin config hooks hub hud mesh scripts tests .claude-plugin .github package.json package-lock.json biome.json",
+    "lint:fix": "biome check --write bin config hooks hub hud mesh scripts tests .claude-plugin .github package.json package-lock.json biome.json",
+    "health": "npm test && npm run lint",
+    "test": "node scripts/test-lock.mjs --test --test-force-exit --test-concurrency=8 \"tests/**/*.test.mjs\" \"scripts/__tests__/**/*.test.mjs\"",
+    "test:guard-codex-config": "node scripts/check-codex-config-stable.mjs npm test",
+    "test:unit": "node scripts/test-lock.mjs --test --test-force-exit --test-concurrency=8 tests/unit/**/*.test.mjs",
+    "test:integration": "node scripts/test-lock.mjs --test --test-force-exit --test-concurrency=8 tests/integration/**/*.test.mjs",
+    "test:route-smoke": "node scripts/test-lock.mjs --test scripts/test-tfx-route-no-claude-native.mjs",
+    "test:contract": "node scripts/test-lock.mjs --test --test-force-exit --test-concurrency=8 tests/contract/**/*.test.mjs",
+    "test:coverage": "node --experimental-test-coverage --test-coverage-lines=60 --test-coverage-functions=60 --test --test-force-exit --test-concurrency=8 \"tests/**/*.test.mjs\"",
+    "gen:skill-docs": "node scripts/gen-skill-docs.mjs",
+    "gen:skill-manifest": "node scripts/gen-skill-manifest.mjs",
+    "release:check-sync": "node scripts/release/check-sync.mjs",
+    "release:check-sync:fix": "node scripts/release/check-sync.mjs --fix",
+    "release:check-mirror": "node scripts/release/check-packages-mirror.mjs",
+    "release:check-mirror:fix": "node scripts/release/check-packages-mirror.mjs --fix",
+    "release:bump": "node scripts/release/bump-version.mjs",
+    "release:prepare": "node scripts/release/prepare.mjs",
+    "release:publish": "node scripts/release/publish.mjs",
+    "release:verify": "node scripts/release/verify.mjs"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/tellang/triflux.git"
+  },
+  "homepage": "https://github.com/tellang/triflux#readme",
+  "author": "tellang",
+  "license": "MIT",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "better-sqlite3": "^12.6.2",
+    "pino": "^10.3.1",
+    "pino-pretty": "^13.1.3",
+    "systray2": "^2.1.4",
+    "zod": "^4.0.0"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "^2.0.0",
+    "knip": "^6.3.0"
+  },
   "keywords": [
     "claude-code",
     "plugin",
@@ -46,13 +98,5 @@
     "multi-model",
     "triflux",
     "tfx"
-  ],
-  "author": "tellang",
-  "license": "MIT",
-  "homepage": "https://github.com/tellang/triflux#readme",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/tellang/triflux.git",
-    "directory": "packages/triflux"
-  }
+  ]
 }

package/scripts/mcp-gateway-ensure.mjs

@@ -3,7 +3,7 @@
 // mcp-gateway-ensure.mjs — SessionStart 훅에서 supergateway MCP 서비스 보장
 // hub-ensure.mjs 패턴을 따름. 가볍게 헬스체크만 수행하고 필요시 기동.
 
-import { execSync } from "node:child_process";
+import { execSync, spawn } from "node:child_process";
 import { existsSync } from "node:fs";
 import { tmpdir } from "node:os";
 import { dirname, join } from "node:path";
@@ -36,10 +36,19 @@ function startGateway() {
   if (!existsSync(scriptPath)) return false;
 
   try {
-    execSync(
-      `powershell -NoProfile -Command "Start-Process -WindowStyle Hidden -FilePath '${process.execPath}' -ArgumentList '${scriptPath.replaceAll("'", "''")}'"`,
-      { stdio: "ignore", timeout: 10000 },
-    );
+    if (process.platform === "win32") {
+      execSync(
+        `powershell -NoProfile -Command "Start-Process -WindowStyle Hidden -FilePath '${process.execPath}' -ArgumentList '${scriptPath.replaceAll("'", "''")}'"`,
+        { stdio: "ignore", timeout: 10000 },
+      );
+    } else {
+      // POSIX: detached node child + stdio:'ignore' so SessionStart 훅이 block 되지 않음
+      const child = spawn(process.execPath, [scriptPath], {
+        detached: true,
+        stdio: "ignore",
+      });
+      child.unref();
+    }
     return true;
   } catch {
     return false;

package/scripts/mcp-gateway-integration-test.mjs

@@ -51,18 +51,34 @@ function runScript(scriptPath, ...args) {
 }
 
 function countSupergateways() {
+  if (process.platform === "win32") {
+    try {
+      // Write the query as a PS1 file to avoid shell quoting issues
+      const ps1 = [
+        `$procs = Get-CimInstance Win32_Process -Filter "Name='node.exe' OR Name='cmd.exe'"`,
+        `$hits = $procs | Where-Object { $_.CommandLine -match 'supergateway' }`,
+        `Write-Output $hits.Count`,
+      ].join("\n");
+      const out = execSync(
+        `powershell -NoProfile -Command "${ps1.replace(/\n/g, "; ")}"`,
+        { encoding: "utf8", timeout: 10000, stdio: ["pipe", "pipe", "ignore"] },
+      );
+      return parseInt(out.trim(), 10) || 0;
+    } catch {
+      return 0;
+    }
+  }
+
+  // POSIX: pgrep -f → 줄별 PID. macOS BSD pgrep 은 `-c` 미지원이라
+  // PID 목록을 받아 줄 수로 카운트한다. 0 match 시 exit 1.
   try {
-    // Write the query as a PS1 file to avoid shell quoting issues
-    const ps1 = [
-      `$procs = Get-CimInstance Win32_Process -Filter "Name='node.exe' OR Name='cmd.exe'"`,
-      `$hits = $procs | Where-Object { $_.CommandLine -match 'supergateway' }`,
-      `Write-Output $hits.Count`,
-    ].join("\n");
-    const out = execSync(
-      `powershell -NoProfile -Command "${ps1.replace(/\n/g, "; ")}"`,
-      { encoding: "utf8", timeout: 10000, stdio: ["pipe", "pipe", "ignore"] },
-    );
-    return parseInt(out.trim(), 10) || 0;
+    const out = execSync("pgrep -f supergateway", {
+      encoding: "utf8",
+      stdio: ["ignore", "pipe", "ignore"],
+      timeout: 5000,
+    });
+    const trimmed = out.trim();
+    return trimmed ? trimmed.split("\n").filter(Boolean).length : 0;
   } catch {
     return 0;
   }

package/scripts/mcp-gateway-start.mjs

@@ -4,7 +4,7 @@
 //        node mcp-gateway-start.mjs --stop   # 중지
 //        node mcp-gateway-start.mjs --status # 상태 확인
 
-import { execSync } from "node:child_process";
+import { execSync, spawn } from "node:child_process";
 import { existsSync, readFileSync, unlinkSync, writeFileSync } from "node:fs";
 import { createConnection } from "node:net";
 import { tmpdir } from "node:os";
@@ -104,16 +104,41 @@ function sleep(ms) {
 // ── 시작 ──
 
 function spawnGateway(srv) {
-  // 임시 .cmd 파일로 quoting 문제 회피
-  const cmdContent = `@echo off\nnpx -y supergateway --stdio "${srv.cmd}" --port ${srv.port} --outputTransport sse --healthEndpoint /healthz --cors "http://localhost"`;
-  const cmdFile = join(tmpdir(), `tfx-sg-${srv.name}.cmd`);
-  writeFileSync(cmdFile, cmdContent);
-
-  // PowerShell Start-Process: Windows Job Object에서 벗어나 부모 종료 후 생존
-  execSync(
-    `powershell -NoProfile -Command "Start-Process -WindowStyle Hidden -FilePath cmd.exe -ArgumentList '/c','${cmdFile.replaceAll("'", "''")}'"`,
-    { stdio: "ignore", timeout: 10000 },
-  );
+  if (process.platform === "win32") {
+    // 임시 .cmd 파일로 quoting 문제 회피
+    const cmdContent = `@echo off\nnpx -y supergateway --stdio "${srv.cmd}" --port ${srv.port} --outputTransport sse --healthEndpoint /healthz --cors "http://localhost"`;
+    const cmdFile = join(tmpdir(), `tfx-sg-${srv.name}.cmd`);
+    writeFileSync(cmdFile, cmdContent);
+
+    // PowerShell Start-Process: Windows Job Object에서 벗어나 부모 종료 후 생존
+    execSync(
+      `powershell -NoProfile -Command "Start-Process -WindowStyle Hidden -FilePath cmd.exe -ArgumentList '/c','${cmdFile.replaceAll("'", "''")}'"`,
+      { stdio: "ignore", timeout: 10000 },
+    );
+    return;
+  }
+
+  // POSIX (macOS/Linux): detached child + stdio:'ignore' so parent can exit
+  // 부모 process 가 죽어도 daemon 이 살아남도록 detached + unref.
+  const args = [
+    "-y",
+    "supergateway",
+    "--stdio",
+    srv.cmd,
+    "--port",
+    String(srv.port),
+    "--outputTransport",
+    "sse",
+    "--healthEndpoint",
+    "/healthz",
+    "--cors",
+    "http://localhost",
+  ];
+  const child = spawn("npx", args, {
+    detached: true,
+    stdio: "ignore",
+  });
+  child.unref();
 }
 
 function ensureFirewallRule() {
@@ -221,30 +246,57 @@ async function startAll() {
 // ── 중지 ──
 
 function stopAll() {
-  // supergateway + 하위 MCP 프로세스를 포트 기반으로 찾아 종료
-  try {
-    // temp .ps1 파일로 bash/cmd 쿼팅 충돌 회피
-    const psFile = join(tmpdir(), "tfx-sg-stop.ps1");
-    writeFileSync(
-      psFile,
-      [
-        `Get-CimInstance Win32_Process -Filter "Name='node.exe' OR Name='cmd.exe'" |`,
-        `  Where-Object { $_.CommandLine -match 'supergateway' } |`,
-        `  ForEach-Object { taskkill /F /T /PID $_.ProcessId 2>$null; Write-Output "[STOP] PID $($_.ProcessId)" }`,
-      ].join("\n"),
-    );
-    const output = execSync(
-      `powershell -NoProfile -ExecutionPolicy Bypass -File "${psFile}"`,
-      {
+  // supergateway + 하위 MCP 프로세스를 cmdline 기반으로 찾아 종료
+  if (process.platform === "win32") {
+    try {
+      // temp .ps1 파일로 bash/cmd 쿼팅 충돌 회피
+      const psFile = join(tmpdir(), "tfx-sg-stop.ps1");
+      writeFileSync(
+        psFile,
+        [
+          `Get-CimInstance Win32_Process -Filter "Name='node.exe' OR Name='cmd.exe'" |`,
+          `  Where-Object { $_.CommandLine -match 'supergateway' } |`,
+          `  ForEach-Object { taskkill /F /T /PID $_.ProcessId 2>$null; Write-Output "[STOP] PID $($_.ProcessId)" }`,
+        ].join("\n"),
+      );
+      const output = execSync(
+        `powershell -NoProfile -ExecutionPolicy Bypass -File "${psFile}"`,
+        {
+          encoding: "utf8",
+          timeout: 10000,
+          stdio: ["pipe", "pipe", "ignore"],
+        },
+      );
+      if (output.trim()) console.log(output.trim());
+      else console.log("[gateway] No supergateway processes found");
+    } catch {
+      console.log("[gateway] No supergateway processes found");
+    }
+  } else {
+    // POSIX: pgrep -f 로 cmdline match → kill -TERM. pgrep 은 0 hit 시 exit 1.
+    try {
+      const out = execSync("pgrep -f supergateway", {
         encoding: "utf8",
-        timeout: 10000,
-        stdio: ["pipe", "pipe", "ignore"],
-      },
-    );
-    if (output.trim()) console.log(output.trim());
-    else console.log("[gateway] No supergateway processes found");
-  } catch {
-    console.log("[gateway] No supergateway processes found");
+        stdio: ["ignore", "pipe", "ignore"],
+        timeout: 5000,
+      }).trim();
+      const pids = out ? out.split("\n").filter(Boolean) : [];
+      if (pids.length === 0) {
+        console.log("[gateway] No supergateway processes found");
+      } else {
+        for (const pid of pids) {
+          try {
+            execSync(`kill -TERM ${pid}`, { stdio: "ignore" });
+            console.log(`[STOP] PID ${pid}`);
+          } catch {
+            /* 이미 죽었거나 권한 부족 — 다음 PID 시도 */
+          }
+        }
+      }
+    } catch {
+      // pgrep no match → exit 1
+      console.log("[gateway] No supergateway processes found");
+    }
   }
 
   if (existsSync(PID_FILE)) {

package/skills/tfx-research/SKILL.md

@@ -1,7 +1,7 @@
 ---
 internal: true
 name: tfx-research
-description: "웹 검색/리서치가 필요할 때 사용한다. '검색해줘', '찾아봐', '최신 정보', '이거 뭐야', '심층 조사', '자세히 알아봐', 'deep research', '전면 리서치', '자율 리서치', '조사해', 'research and plan' 같은 요청에 반드시 사용. 기본값은 3-CLI 멀티소스(Exa+Brave+Tavily) 합의 딥 리서치. 빠른 Gemini Google Search 는 --quick. 자율 쿼리생성+보고서 모드는 --auto."
+description: "웹 검색/리서치가 필요할 때 사용한다. '검색해줘', '찾아봐', '최신 정보', '이거 뭐야', '심층 조사', '자세히 알아봐', 'deep research', '전면 리서치', '자율 리서치', '조사해', 'research and plan' 같은 요청에 반드시 사용. 추가로 'X 있나?', 'X 쓸 수 있나?', 'X 풀려있어?', 'X 어떻게 쓰는지', 'X 가능한가?', '방법 있나?', 'X 살아있나?' 같은 도구·기능 존재/사용법/상태 의문문에도 사용. 기본값은 3-CLI 멀티소스(Exa+Brave+Tavily) 합의 딥 리서치. 빠른 Gemini Google Search 는 --quick. 자율 쿼리생성+보고서 모드는 --auto."
 triggers:
   - tfx-research
   - 리서치