triflux 10.9.1 → 10.9.3

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": "CLI-first multi-model orchestrator for Claude Code. Routes tasks to Codex, Gemini, and Claude CLIs with automatic triage, DAG-based parallel execution, headless psmux sessions, and cost-optimized routing. Includes 41 skills, HUD status bar, hook orchestrator, and shell-based CLI routing.",
+      "version": "10.9.3",
+      "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.3.2"
+}

package/.claude-plugin/plugin.json

@@ -0,0 +1,22 @@
+{
+  "name": "triflux",
+  "version": "10.3.4",
+  "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/README.ko.md

@@ -37,27 +37,22 @@
 
 ## 빠른 시작
 
-### 1. 설치
+**Claude Code** (권장):
 
-**Claude Code 플러그인** (권장):
-
-```bash
-claude plugin add triflux
+```
+/plugin marketplace add tellang/triflux
+/plugin install triflux@tellang
 ```
 
-**npm 글로벌**:
+**npm**:
 
 ```bash
 npm install -g triflux
 ```
 
-### 2. 설정
-
-```bash
-tfx setup
-```
+`tfx setup`으로 환경을 설정하세요.
 
-### 3. 사용법
+### 사용법
 
 ```bash
 # Light — 단일 모델로 빠르게 실행
@@ -292,27 +287,22 @@ graph TD
 
 ## 빠른 시작
 
-### 1. 설치
+**Claude Code** (권장):
 
-**Claude Code 플러그인** (권장):
-
-```bash
-claude plugin add triflux
+```
+/plugin marketplace add tellang/triflux
+/plugin install triflux@tellang
 ```
 
-**npm 글로벌**:
+**npm**:
 
 ```bash
 npm install -g triflux
 ```
 
-### 2. 설정
-
-```bash
-tfx setup
-```
+`tfx setup`으로 환경을 설정하세요.
 
-### 3. 사용법
+### 사용법
 
 ```bash
 # Light — 단일 모델로 빠르게 실행

package/README.md

@@ -61,27 +61,22 @@ You don't need to memorize commands. Say what you want in natural language — t
 
 ## Quick Start
 
-### 1. Install
+**Claude Code** (recommended):
 
-**Claude Code Plugin** (recommended):
-
-```bash
-claude plugin add triflux
+```
+/plugin marketplace add tellang/triflux
+/plugin install triflux@tellang
 ```
 
-**npm global**:
+**npm**:
 
 ```bash
 npm install -g triflux
 ```
 
-### 2. Setup
-
-```bash
-tfx setup
-```
+Then run `tfx setup` to configure your environment.
 
-### 3. Use
+### Use
 
 ```bash
 # 3-party consensus — three models argue, only consensus survives

package/bin/triflux.mjs

@@ -1047,14 +1047,13 @@ function cmdSetup(options = {}) {
   }
   {
     const claudeGuide = ensureGlobalClaudeRoutingSection(CLAUDE_DIR);
-    if (claudeGuide.skipped)
+    if (claudeGuide.skipped && claudeGuide.reason !== "global_sync_disabled")
       warn(`CLAUDE.md 라우팅 섹션 확인 실패: ${claudeGuide.reason}`);
     else if (
       claudeGuide.action === "created" ||
       claudeGuide.action === "updated"
     )
       ok("CLAUDE.md: 전역 triflux 라우팅 요약 갱신");
-    else ok("CLAUDE.md: 전역 triflux 라우팅 요약 유지");
   }
 
   // 스킬 동기화 (~/.claude/skills/{name}/SKILL.md)
@@ -1847,7 +1846,7 @@ async function cmdDoctor(options = {}) {
       }
       {
         const claudeGuide = ensureGlobalClaudeRoutingSection(CLAUDE_DIR);
-        if (claudeGuide.skipped)
+        if (claudeGuide.skipped && claudeGuide.reason !== "global_sync_disabled")
           warn(`CLAUDE.md 라우팅 섹션 확인 실패: ${claudeGuide.reason}`);
         else if (
           claudeGuide.action === "created" ||

package/config/mcp-registry.json

@@ -0,0 +1,29 @@
+{
+  "$schema": "mcp-registry-schema",
+  "version": 1,
+  "description": "MCP 서버 중앙 레지스트리 — 진실의 원천",
+  "defaults": {
+    "transport": "hub-url",
+    "hub_base": "http://127.0.0.1:27888"
+  },
+  "servers": {
+    "tfx-hub": {
+      "transport": "hub-url",
+      "url": "http://127.0.0.1:27888/mcp",
+      "safe": true,
+      "targets": ["claude", "gemini", "codex"],
+      "description": "triflux Hub MCP 서버"
+    }
+  },
+  "policies": {
+    "stdio_action": "replace-with-hub",
+    "unknown_server_action": "warn",
+    "watched_paths": [
+      "~/.gemini/settings.json",
+      "~/.codex/config.toml",
+      "~/.claude/settings.json",
+      "~/.claude/settings.local.json",
+      ".mcp.json"
+    ]
+  }
+}

package/hooks/hook-registry.json

@@ -167,8 +167,8 @@
         "priority": 2,
         "enabled": true,
         "timeout": 8,
-        "blocking": false,
-        "description": "tfx-hub 서비스 헬스체크 및 시작"
+        "blocking": true,
+        "description": "tfx-hub 서비스 헬스체크 및 시작 (BLOCKING — 세션 시작 전 Hub 준비 보장)"
       },
       {
         "id": "tfx-preflight-cache",

package/hooks/session-start-fast.mjs

@@ -4,8 +4,8 @@
 // 6개 훅을 1개 node 프로세스 안에서 실행하여 콜드스타트 7회 → 1회로 줄인다.
 //
 // 분류:
-//   BLOCKING  (직렬, stdout 반환 전 완료): setup.runCritical, mcp-safety-guard.run
-//   DEFERRED  (병렬, 실패해도 안 죽음):   hub-ensure.run, mcp-gateway-ensure.run, setup.runDeferred
+//   BLOCKING  (직렬, stdout 반환 전 완료): setup.runCritical, mcp-safety-guard.run, hub-ensure.run
+//   DEFERRED  (병렬, 실패해도 안 죽음):   mcp-gateway-ensure.run, setup.runDeferred
 //   BACKGROUND (fire-and-forget):          preflight-cache.run
 //
 // external source 훅 (session-vault 등)은 여전히 execFile로 실행된다.
@@ -55,6 +55,24 @@ async function runBlocking(stdinData) {
     log.error({ hook: "mcp-safety-guard", err: String(err.message || err) }, "hook.failed");
   }
 
+  // 3. hub-ensure — Hub 필수 인프라, BLOCKING으로 실행
+  try {
+    const t0 = performance.now();
+    const hubMod = await importMod(join(SCRIPTS, "hub-ensure.mjs"));
+    const result = await hubMod.run(stdinData);
+    const dur = performance.now() - t0;
+    timings.push({ hook: "hub-ensure", dur_ms: Math.round(dur) });
+    if (result?.stdout) output.stdout += result.stdout + "\n";
+    if (result?.stderr) output.stderr += result.stderr + "\n";
+    if (result?.code !== 0) {
+      log.warn({ hook: "hub-ensure", dur_ms: Math.round(dur), code: result?.code }, "hook.warn");
+    } else {
+      log.info({ hook: "hub-ensure", dur_ms: Math.round(dur) }, "hook.completed");
+    }
+  } catch (err) {
+    log.error({ hook: "hub-ensure", err: String(err.message || err) }, "hook.failed");
+  }
+
   return { ...output, timings };
 }
 
@@ -65,13 +83,6 @@ async function runBlocking(stdinData) {
  */
 function runDeferred(stdinData) {
   const tasks = [
-    {
-      name: "hub-ensure",
-      fn: async () => {
-        const mod = await importMod(join(SCRIPTS, "hub-ensure.mjs"));
-        return mod.run(stdinData);
-      },
-    },
     {
       name: "mcp-gateway-ensure",
       fn: async () => {
@@ -134,7 +145,7 @@ export async function execute(stdinData, externalHooks = []) {
   runBackground(stdinData);
 
   const totalDur = performance.now() - totalStart;
-  log.info({ total_ms: Math.round(totalDur), blocking_count: 2, deferred_count: 3, bg_count: 1 }, "session-start.done");
+  log.info({ total_ms: Math.round(totalDur), blocking_count: 3, deferred_count: 2, bg_count: 1 }, "session-start.done");
 
   return {
     stdout: blocking.stdout,

package/hub/pipe.mjs

@@ -125,6 +125,7 @@ export function createPipeServer({
   heartbeatTtlMs = DEFAULT_HEARTBEAT_TTL_MS,
   delegatorService = null,
   hitlManager = null,
+  onActivity = null,
 } = {}) {
   if (!router) {
     throw new Error("router is required");
@@ -164,6 +165,7 @@ export function createPipeServer({
 
   function touchClient(client) {
     client.lastHeartbeatMs = Date.now();
+    if (onActivity) onActivity();
   }
 
   function resolveAgentId(client, payload) {

package/hub/server.mjs

@@ -580,6 +580,7 @@ export async function startHub({
     sessionId,
     delegatorService,
     hitlManager: hitl,
+    onActivity: markRequestActivity,
   });
   const assignCallbacks = createAssignCallbackServer({ store, sessionId });
   const tools = createTools(store, router, hitl, pipe);
@@ -1660,6 +1661,23 @@ if (selfRun) {
   const port = parseInt(process.env.TFX_HUB_PORT || "27888", 10);
   const dbPath = process.env.TFX_HUB_DB || undefined;
 
+  const cleanupPidFile = () => {
+    try {
+      unlinkSync(PID_FILE);
+    } catch {}
+  };
+
+  process.on("unhandledRejection", (err) => {
+    hubLog.fatal({ err }, "hub.unhandledRejection");
+    cleanupPidFile();
+    process.exit(1);
+  });
+  process.on("uncaughtException", (err) => {
+    hubLog.fatal({ err }, "hub.uncaughtException");
+    cleanupPidFile();
+    process.exit(1);
+  });
+
   startHub({ port, dbPath })
     .then((info) => {
       const shutdown = async (signal) => {
@@ -1678,6 +1696,7 @@ if (selfRun) {
     })
     .catch((error) => {
       hubLog.fatal({ err: error }, "hub.start_failed");
+      cleanupPidFile();
       process.exit(1);
     });
 }

package/hub/state.mjs

@@ -256,8 +256,9 @@ export async function acquireLock(options = {}) {
         const raw = readFileSync(lockPath, "utf8");
         const data = parseJson(raw, {});
         const stats = statSync(lockPath);
+        const STALE_LOCK_AGE_MS = 60_000;
         const staleByPid = !isPidAlive(data?.pid);
-        const staleByAge = Date.now() - stats.mtimeMs > timeoutMs;
+        const staleByAge = Date.now() - stats.mtimeMs > STALE_LOCK_AGE_MS;
         if (staleByPid || staleByAge) {
           try {
             unlinkSync(lockPath);

package/hud/hud-qos-status.mjs

@@ -138,9 +138,7 @@ async function main() {
   // 실측 데이터 추출
   const stdin = await stdinPromise;
   const contextView = buildContextUsageView(stdin, contextSnapshot);
-  const claudeUsage = claudeUsageSnapshot.isStale
-    ? { ...(claudeUsageSnapshot.data || {}), stale: true }
-    : claudeUsageSnapshot.data;
+  const claudeUsage = claudeUsageSnapshot.data;
   const codexEmail = getCodexEmail();
   const geminiEmail = getGeminiEmail();
   const codexBuckets = codexSnapshot.buckets;

package/hud/renderers.mjs

@@ -263,8 +263,6 @@ export function getMicroLine(
   combinedSvPct,
 ) {
   const ctxView = contextView || buildContextUsageView({}, null);
-  const staleMarker = claudeUsage?.stale ? ` ${dim("[stale]")}` : "";
-
   // Claude 5h/1w
   const cF =
     claudeUsage?.fiveHourPercent != null
@@ -319,7 +317,7 @@ export function getMicroLine(
     `${bold(codexWhite("x"))}${dim(":")}${xVal} ` +
     `${bold(geminiBlue("g"))}${dim(":")}${gVal} ` +
     `${dim("sv:")}${sv} ` +
-    `${dim("CTX:")}${colorByPercent(ctxView.percent, ctxView.display)}${staleMarker}`;
+    `${dim("CTX:")}${colorByPercent(ctxView.percent, ctxView.display)}`;
   return truncateAnsi(line, cols);
 }
 
@@ -334,8 +332,6 @@ export function getClaudeRows(
 ) {
   const ctxView = contextView || buildContextUsageView({}, null);
   const prefix = `${bold(claudeOrange("c"))}:`;
-  const staleMarker = claudeUsage?.stale ? ` ${dim("[stale]")}` : "";
-
   // 절약 퍼센트
   const svStr = formatSvPct(combinedSvPct || 0);
   const svSuffix = `${dim("sv:")}${svStr}`;
@@ -388,18 +384,18 @@ export function getClaudeRows(
       hasData && weeklyPercent != null
         ? colorByProvider(weeklyPercent, `${weeklyPercent}%`, claudeOrange)
         : dim("--");
-    const quotaSection = `${fShort}${dim("/")}${wShort}${staleMarker}`;
+    const quotaSection = `${fShort}${dim("/")}${wShort}`;
     return [{ prefix, left: quotaSection, right: "" }];
   }
 
   if (currentTier === "minimal") {
-    const quotaSection = `${dim("5h:")}${fStr} ${dim("1w:")}${wStr}${staleMarker}`;
+    const quotaSection = `${dim("5h:")}${fStr} ${dim("1w:")}${wStr}`;
     const right = `${dim("CTX:")}${colorByPercent(ctxView.percent, ctxView.display)}`;
     return [{ prefix, left: quotaSection, right }];
   }
 
   if (currentTier === "compact") {
-    const quotaSection = `${dim("5h:")}${fStr} ${dim(fTime)} ${dim("1w:")}${wStr} ${dim(wTime)}${staleMarker}`;
+    const quotaSection = `${dim("5h:")}${fStr} ${dim(fTime)} ${dim("1w:")}${wStr} ${dim(wTime)}`;
     const warning = ctxView.warningTag
       ? ` ${dim("|")} ${yellow(ctxView.warningTag)}`
       : "";
@@ -408,7 +404,7 @@ export function getClaudeRows(
   }
 
   // full tier (>= 120 cols)
-  const quotaSection = `${dim("5h:")}${fBar}${fStr} ${dim(fTime)} ${dim("1w:")}${wBar}${wStr} ${dim(wTime)}${staleMarker}`;
+  const quotaSection = `${dim("5h:")}${fBar}${fStr} ${dim(fTime)} ${dim("1w:")}${wBar}${wStr} ${dim(wTime)}`;
   const warning = ctxView.warningTag
     ? ` ${dim("|")} ${yellow(ctxView.warningTag)}`
     : "";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "triflux",
-  "version": "10.9.1",
+  "version": "10.9.3",
   "description": "CLI-first multi-model orchestrator for Claude Code — route tasks to Codex, Gemini, and Claude",
   "type": "module",
   "bin": {
@@ -13,26 +13,69 @@
     "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",
-    "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",
+    "lint": "biome check .",
+    "lint:fix": "biome check --fix .",
+    "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: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"
+  },
+  "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.27.1",
+    "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",
@@ -43,13 +86,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/hub-ensure.mjs

@@ -52,12 +52,12 @@ function resolveHubTarget() {
 
 async function isHubHealthy(host, port) {
   try {
-    const res = await fetch(`${buildHubBaseUrl(host, port)}/status`, {
+    const res = await fetch(`${buildHubBaseUrl(host, port)}/health`, {
       signal: AbortSignal.timeout(1000),
     });
     if (!res.ok) return false;
     const data = await res.json();
-    return data?.hub?.state === "healthy";
+    return data?.ok === true;
   } catch {
     return false;
   }
@@ -69,25 +69,13 @@ function startHubDetached(port) {
 
   try {
     const env = { ...process.env, TFX_HUB_PORT: String(port) };
-    if (process.platform === "win32") {
-      const child = spawn(
-        "cmd.exe",
-        ["/c", "start", "/b", "", process.execPath, serverPath],
-        {
-          env,
-          stdio: "ignore",
-          windowsHide: true,
-        },
-      );
-      child.unref();
-    } else {
-      const child = spawn(process.execPath, [serverPath], {
-        env,
-        detached: true,
-        stdio: "ignore",
-      });
-      child.unref();
-    }
+    const child = spawn(process.execPath, [serverPath], {
+      env,
+      detached: true,
+      stdio: "ignore",
+      windowsHide: true,
+    });
+    child.unref();
     return true;
   } catch {
     return false;
@@ -114,13 +102,13 @@ export async function run(stdinData) {
 
   const started = startHubDetached(port);
   if (!started) {
-    return { code: 0, stdout: "", stderr: "[hub-ensure] hub 시작 실패" };
+    return { code: 1, stdout: "", stderr: "[hub-ensure] hub 시작 실패" };
   }
 
-  const ready = await waitForHubReady(host, port, 3000);
+  const ready = await waitForHubReady(host, port, 5000);
   return {
-    code: 0,
-    stdout: ready ? "hub: ok" : "hub: starting",
+    code: ready ? 0 : 2,
+    stdout: ready ? "hub: ok" : "hub: starting (timeout)",
     stderr: "",
   };
 }

package/scripts/tfx-route.sh

@@ -920,7 +920,7 @@ route_agent() {
 TFX_CLI_MODE="${TFX_CLI_MODE:-auto}"
 TFX_NO_CLAUDE_NATIVE="${TFX_NO_CLAUDE_NATIVE:-0}"
 TFX_VERIFIER_OVERRIDE="${TFX_VERIFIER_OVERRIDE:-auto}"
-TFX_CODEX_TRANSPORT="${TFX_CODEX_TRANSPORT:-exec}"
+TFX_CODEX_TRANSPORT="${TFX_CODEX_TRANSPORT:-auto}"
 # Preflight 캐시 일괄 로드 — CLI/Hub 가용성 + Codex 요금제를 환경변수로 내보냄
 # 하위 프로세스(스킬 포함)가 TFX_CODEX_OK, TFX_GEMINI_OK, TFX_HUB_OK로 즉시 참조 가능
 if [[ -z "${TFX_PREFLIGHT_LOADED:-}" ]]; then