triflux 3.3.0-dev.7 → 4.0.0

package/scripts/setup.mjs

@@ -57,21 +57,21 @@ const SYNC_MAP = [
     dst: join(CLAUDE_DIR, "scripts", "tfx-route-worker.mjs"),
     label: "tfx-route-worker.mjs",
   },
-  {
-    src: join(PLUGIN_ROOT, "hub", "workers", "codex-mcp.mjs"),
-    dst: join(CLAUDE_DIR, "scripts", "hub", "workers", "codex-mcp.mjs"),
-    label: "hub/workers/codex-mcp.mjs",
-  },
-  {
-    src: join(PLUGIN_ROOT, "hub", "workers", "delegator-mcp.mjs"),
-    dst: join(CLAUDE_DIR, "scripts", "hub", "workers", "delegator-mcp.mjs"),
-    label: "hub/workers/delegator-mcp.mjs",
-  },
-  {
-    src: join(PLUGIN_ROOT, "hub", "workers", "interface.mjs"),
-    dst: join(CLAUDE_DIR, "scripts", "hub", "workers", "interface.mjs"),
-    label: "hub/workers/interface.mjs",
-  },
+  {
+    src: join(PLUGIN_ROOT, "hub", "workers", "codex-mcp.mjs"),
+    dst: join(CLAUDE_DIR, "scripts", "hub", "workers", "codex-mcp.mjs"),
+    label: "hub/workers/codex-mcp.mjs",
+  },
+  {
+    src: join(PLUGIN_ROOT, "hub", "workers", "delegator-mcp.mjs"),
+    dst: join(CLAUDE_DIR, "scripts", "hub", "workers", "delegator-mcp.mjs"),
+    label: "hub/workers/delegator-mcp.mjs",
+  },
+  {
+    src: join(PLUGIN_ROOT, "hub", "workers", "interface.mjs"),
+    dst: join(CLAUDE_DIR, "scripts", "hub", "workers", "interface.mjs"),
+    label: "hub/workers/interface.mjs",
+  },
   {
     src: join(PLUGIN_ROOT, "hub", "workers", "gemini-worker.mjs"),
     dst: join(CLAUDE_DIR, "scripts", "hub", "workers", "gemini-worker.mjs"),
@@ -377,28 +377,65 @@ if (existsSync(mcpCheck)) {
   const child = spawn(process.execPath, [mcpCheck], {
     detached: true,
     stdio: "ignore",
+    windowsHide: true,
   });
   child.unref(); // 부모 프로세스와 분리 — 비동기 실행
 }
 
-// ── Hub 헬스체크 + 자동 기동 (세션 시작 백그라운드) ──
-// setup 훅이 포그라운드 지연을 만들지 않도록 별도 detached 프로세스로 처리한다.
-const hubEnsure = join(PLUGIN_ROOT, "scripts", "hub-ensure.mjs");
-const isPostinstall = process.env.npm_lifecycle_event === "postinstall";
-const isCi = /^(1|true)$/i.test(process.env.CI || "");
-const disableHubAutostart = process.env.TFX_DISABLE_HUB_AUTOSTART === "1";
+// ── SessionStart 훅 자동 등록 (settings.json) ──
+// .claude-plugin/ 개발 플러그인의 SessionStart 훅은 플러그인 로드 시점 문제로
+// 실행되지 않을 수 있으므로, settings.json에 직접 등록한다.
+// hub-ensure.mjs는 settings.json 훅으로만 실행 (이중 spawn 방지).
 
-if (!isPostinstall && !isCi && !disableHubAutostart && existsSync(hubEnsure)) {
-  try {
-    const child = spawn(process.execPath, [hubEnsure], {
-      env: process.env,
-      detached: true,
-      stdio: "ignore",
-    });
-    child.unref();
-  } catch {
-    // best effort: 실패해도 setup 흐름은 지속
+try {
+  let hookSettings = {};
+  if (existsSync(settingsPath)) {
+    hookSettings = JSON.parse(readFileSync(settingsPath, "utf8"));
+  }
+
+  if (!hookSettings.hooks) hookSettings.hooks = {};
+  if (!Array.isArray(hookSettings.hooks.SessionStart)) {
+    hookSettings.hooks.SessionStart = [];
+  }
+
+  const existingHooks = hookSettings.hooks.SessionStart;
+  const hasTrifluxHooks = existingHooks.some((entry) =>
+    Array.isArray(entry.hooks) &&
+    entry.hooks.some((h) => typeof h.command === "string" && h.command.includes("triflux")),
+  );
+
+  if (!hasTrifluxHooks) {
+    const nodePath = process.execPath.replace(/\\/g, "/");
+    const nodeRef = nodePath.includes(" ") ? `"${nodePath}"` : nodePath;
+    const pluginRoot = PLUGIN_ROOT.replace(/\\/g, "/");
+
+    const trifluxHookEntry = {
+      matcher: "*",
+      hooks: [
+        {
+          type: "command",
+          command: `${nodeRef} "${pluginRoot}/scripts/setup.mjs"`,
+          timeout: 10,
+        },
+        {
+          type: "command",
+          command: `${nodeRef} "${pluginRoot}/scripts/hub-ensure.mjs"`,
+          timeout: 8,
+        },
+        {
+          type: "command",
+          command: `${nodeRef} "${pluginRoot}/scripts/preflight-cache.mjs"`,
+          timeout: 5,
+        },
+      ],
+    };
+
+    hookSettings.hooks.SessionStart.push(trifluxHookEntry);
+    writeFileSync(settingsPath, JSON.stringify(hookSettings, null, 2) + "\n", "utf8");
+    synced++;
   }
+} catch {
+  // settings.json 파싱 실패 시 무시 — 기존 설정 보존
 }
 
 // ── postinstall 배너 (npm install 시에만 출력) ──

package/scripts/test-tfx-route-no-claude-native.mjs

@@ -1,57 +1,57 @@
-#!/usr/bin/env node
-import test from "node:test";
-import assert from "node:assert/strict";
-import { spawnSync } from "node:child_process";
-import { dirname, resolve } from "node:path";
-import { fileURLToPath } from "node:url";
-
-const SCRIPT_DIR = dirname(fileURLToPath(import.meta.url));
-const PROJECT_ROOT = resolve(SCRIPT_DIR, "..");
-
-function runBash(command) {
-  return spawnSync("bash", ["-lc", command], {
-    cwd: PROJECT_ROOT,
-    encoding: "utf8",
-    env: {
-      ...process.env,
-      TFX_TEAM_NAME: '',
-      TFX_TEAM_TASK_ID: '',
-      TFX_TEAM_AGENT_NAME: '',
-      TFX_TEAM_LEAD_NAME: '',
-      TFX_HUB_URL: '',
-      TMUX: '',
-    }
-  });
-}
-
-function out(result) {
-  return `${result.stdout || ""}\n${result.stderr || ""}`;
-}
-
-test("gemini 모드에서는 no-claude-native 강제 치환이 적용되지 않는다", () => {
-  const result = runBash(
-    "TFX_CLI_MODE=gemini TFX_NO_CLAUDE_NATIVE=1 bash scripts/tfx-route.sh explore 'test-case'"
-  );
-
-  assert.equal(result.status, 0, out(result));
-  assert.match(out(result), /ROUTE_TYPE=claude-native/, out(result));
-});
-
-test("auto 모드 + no-claude-native=1이면 explore가 codex로 치환된다", () => {
-  const result = runBash(
-    "TFX_CLI_MODE=auto TFX_NO_CLAUDE_NATIVE=1 CODEX_BIN=true bash scripts/tfx-route.sh explore 'test-case' minimal 5"
-  );
-
-  assert.equal(result.status, 0, out(result));
-  assert.match(out(result), /TFX_NO_CLAUDE_NATIVE=1: explore -> codex/, out(result));
-  assert.match(out(result), /type=codex|cli:\\s*codex/i, out(result));
-});
-
-test("TFX_NO_CLAUDE_NATIVE는 0/1 값만 허용한다", () => {
-  const result = runBash(
-    "TFX_NO_CLAUDE_NATIVE=2 bash scripts/tfx-route.sh explore 'test-case'"
-  );
-
-  assert.notEqual(result.status, 0, out(result));
-  assert.match(out(result), /0 또는 1/, out(result));
-});
+#!/usr/bin/env node
+import test from "node:test";
+import assert from "node:assert/strict";
+import { spawnSync } from "node:child_process";
+import { dirname, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+
+const SCRIPT_DIR = dirname(fileURLToPath(import.meta.url));
+const PROJECT_ROOT = resolve(SCRIPT_DIR, "..");
+
+function runBash(command) {
+  return spawnSync("bash", ["-lc", command], {
+    cwd: PROJECT_ROOT,
+    encoding: "utf8",
+    env: {
+      ...process.env,
+      TFX_TEAM_NAME: '',
+      TFX_TEAM_TASK_ID: '',
+      TFX_TEAM_AGENT_NAME: '',
+      TFX_TEAM_LEAD_NAME: '',
+      TFX_HUB_URL: '',
+      TMUX: '',
+    }
+  });
+}
+
+function out(result) {
+  return `${result.stdout || ""}\n${result.stderr || ""}`;
+}
+
+test("gemini 모드에서는 no-claude-native 강제 치환이 적용되지 않는다", () => {
+  const result = runBash(
+    "TFX_CLI_MODE=gemini TFX_NO_CLAUDE_NATIVE=1 bash scripts/tfx-route.sh explore 'test-case'"
+  );
+
+  assert.equal(result.status, 0, out(result));
+  assert.match(out(result), /ROUTE_TYPE=claude-native/, out(result));
+});
+
+test("auto 모드 + no-claude-native=1이면 explore가 codex로 치환된다", () => {
+  const result = runBash(
+    "TFX_CLI_MODE=auto TFX_NO_CLAUDE_NATIVE=1 CODEX_BIN=true bash scripts/tfx-route.sh explore 'test-case' minimal 5"
+  );
+
+  assert.equal(result.status, 0, out(result));
+  assert.match(out(result), /TFX_NO_CLAUDE_NATIVE=1: explore -> codex/, out(result));
+  assert.match(out(result), /type=codex|cli:\\s*codex/i, out(result));
+});
+
+test("TFX_NO_CLAUDE_NATIVE는 0/1 값만 허용한다", () => {
+  const result = runBash(
+    "TFX_NO_CLAUDE_NATIVE=2 bash scripts/tfx-route.sh explore 'test-case'"
+  );
+
+  assert.notEqual(result.status, 0, out(result));
+  assert.match(out(result), /0 또는 1/, out(result));
+});

package/scripts/tfx-route-worker.mjs

@@ -1,161 +1,161 @@
-#!/usr/bin/env node
-// tfx-route-worker.mjs — tfx-route.sh용 subprocess worker 러너
-
-import { readFileSync, existsSync } from 'node:fs';
-import { dirname, resolve } from 'node:path';
-import { fileURLToPath, pathToFileURL } from 'node:url';
-
-const SCRIPT_DIR = dirname(fileURLToPath(import.meta.url));
-const FACTORY_CANDIDATES = [
-  resolve(SCRIPT_DIR, '../hub/workers/factory.mjs'),
-  resolve(SCRIPT_DIR, './hub/workers/factory.mjs'),
-];
-
-// MCP transport 실패 시 tfx-route.sh가 exec fallback을 수행할 수 있도록
-// CODEX_MCP_TRANSPORT_EXIT_CODE(70)으로 종료한다.
-const MCP_TRANSPORT_EXIT_CODE = 70;
-
-let createWorker = null;
-
-for (const candidate of FACTORY_CANDIDATES) {
-  if (!existsSync(candidate)) continue;
-  try {
-    ({ createWorker } = await import(pathToFileURL(candidate).href));
-  } catch (err) {
-    // 의존성 누락 (예: @modelcontextprotocol/sdk) → fallback 가능하도록 exit 70
-    if (err.code === 'ERR_MODULE_NOT_FOUND') {
-      process.stderr.write(`[tfx-route-worker] 모듈 로드 실패: ${err.message}\n`);
-      process.exit(MCP_TRANSPORT_EXIT_CODE);
-    }
-    throw err;
-  }
-  break;
-}
-
-if (!createWorker) {
-  process.stderr.write('[tfx-route-worker] worker factory를 찾지 못했습니다.\n');
-  process.exit(MCP_TRANSPORT_EXIT_CODE);
-}
-
-function parseArgs(argv) {
-  const args = {
-    allowedMcpServerNames: [],
-    mcpConfig: [],
-  };
-
-  for (let index = 0; index < argv.length; index += 1) {
-    const token = argv[index];
-    const next = argv[index + 1];
-
-    switch (token) {
-      case '--type':
-        args.type = next;
-        index += 1;
-        break;
-      case '--command':
-        args.command = next;
-        index += 1;
-        break;
-      case '--command-args-json':
-        args.commandArgsJson = next;
-        index += 1;
-        break;
-      case '--model':
-        args.model = next;
-        index += 1;
-        break;
-      case '--timeout-ms':
-        args.timeoutMs = Number(next);
-        index += 1;
-        break;
-      case '--approval-mode':
-        args.approvalMode = next;
-        index += 1;
-        break;
-      case '--permission-mode':
-        args.permissionMode = next;
-        index += 1;
-        break;
-      case '--allow-dangerously-skip-permissions':
-        args.allowDangerouslySkipPermissions = true;
-        break;
-      case '--allowed-mcp-server-name':
-        args.allowedMcpServerNames.push(next);
-        index += 1;
-        break;
-      case '--mcp-config':
-        args.mcpConfig.push(next);
-        index += 1;
-        break;
-      case '--cwd':
-        args.cwd = next;
-        index += 1;
-        break;
-      default:
-        throw new Error(`Unknown argument: ${token}`);
-    }
-  }
-
-  if (!args.type) {
-    throw new Error('--type is required');
-  }
-
-  return args;
-}
-
-function parseJsonArray(raw, label) {
-  if (!raw) return [];
-  try {
-    const parsed = JSON.parse(raw);
-    if (!Array.isArray(parsed)) {
-      throw new Error(`${label} must be a JSON array`);
-    }
-    return parsed.map((item) => String(item));
-  } catch (error) {
-    throw new Error(`${label} parse failed: ${error.message}`);
-  }
-}
-
-function readPromptFromStdin() {
-  return readFileSync(0, 'utf8');
-}
-
-function resolveDefaultMcpConfig(cwd) {
-  const candidate = resolve(cwd, '.mcp.json');
-  return existsSync(candidate) ? [candidate] : [];
-}
-
-const args = parseArgs(process.argv.slice(2));
-const prompt = readPromptFromStdin();
-
-const worker = createWorker(args.type, {
-  command: args.command,
-  commandArgs: parseJsonArray(args.commandArgsJson, '--command-args-json'),
-  model: args.model,
-  timeoutMs: args.timeoutMs,
-  approvalMode: args.approvalMode,
-  permissionMode: args.permissionMode,
-  allowDangerouslySkipPermissions: args.allowDangerouslySkipPermissions,
-  allowedMcpServerNames: args.allowedMcpServerNames,
-  mcpConfig: args.type === 'claude' && args.mcpConfig.length === 0
-    ? resolveDefaultMcpConfig(args.cwd || process.cwd())
-    : args.mcpConfig,
-  cwd: args.cwd || process.cwd(),
-});
-
-try {
-  const result = await worker.run(prompt);
-  if (result.response) {
-    process.stdout.write(result.response);
-    if (!result.response.endsWith('\n')) process.stdout.write('\n');
-  }
-} catch (error) {
-  if (error.stderr) {
-    process.stderr.write(String(error.stderr));
-    if (!String(error.stderr).endsWith('\n')) process.stderr.write('\n');
-  }
-  process.stderr.write(`${error.message}\n`);
-  process.exitCode = error.code === 'ETIMEDOUT' ? 124 : 1;
-} finally {
-  try { await worker.stop(); } catch {}
-}
+#!/usr/bin/env node
+// tfx-route-worker.mjs — tfx-route.sh용 subprocess worker 러너
+
+import { readFileSync, existsSync } from 'node:fs';
+import { dirname, resolve } from 'node:path';
+import { fileURLToPath, pathToFileURL } from 'node:url';
+
+const SCRIPT_DIR = dirname(fileURLToPath(import.meta.url));
+const FACTORY_CANDIDATES = [
+  resolve(SCRIPT_DIR, '../hub/workers/factory.mjs'),
+  resolve(SCRIPT_DIR, './hub/workers/factory.mjs'),
+];
+
+// MCP transport 실패 시 tfx-route.sh가 exec fallback을 수행할 수 있도록
+// CODEX_MCP_TRANSPORT_EXIT_CODE(70)으로 종료한다.
+const MCP_TRANSPORT_EXIT_CODE = 70;
+
+let createWorker = null;
+
+for (const candidate of FACTORY_CANDIDATES) {
+  if (!existsSync(candidate)) continue;
+  try {
+    ({ createWorker } = await import(pathToFileURL(candidate).href));
+  } catch (err) {
+    // 의존성 누락 (예: @modelcontextprotocol/sdk) → fallback 가능하도록 exit 70
+    if (err.code === 'ERR_MODULE_NOT_FOUND') {
+      process.stderr.write(`[tfx-route-worker] 모듈 로드 실패: ${err.message}\n`);
+      process.exit(MCP_TRANSPORT_EXIT_CODE);
+    }
+    throw err;
+  }
+  break;
+}
+
+if (!createWorker) {
+  process.stderr.write('[tfx-route-worker] worker factory를 찾지 못했습니다.\n');
+  process.exit(MCP_TRANSPORT_EXIT_CODE);
+}
+
+function parseArgs(argv) {
+  const args = {
+    allowedMcpServerNames: [],
+    mcpConfig: [],
+  };
+
+  for (let index = 0; index < argv.length; index += 1) {
+    const token = argv[index];
+    const next = argv[index + 1];
+
+    switch (token) {
+      case '--type':
+        args.type = next;
+        index += 1;
+        break;
+      case '--command':
+        args.command = next;
+        index += 1;
+        break;
+      case '--command-args-json':
+        args.commandArgsJson = next;
+        index += 1;
+        break;
+      case '--model':
+        args.model = next;
+        index += 1;
+        break;
+      case '--timeout-ms':
+        args.timeoutMs = Number(next);
+        index += 1;
+        break;
+      case '--approval-mode':
+        args.approvalMode = next;
+        index += 1;
+        break;
+      case '--permission-mode':
+        args.permissionMode = next;
+        index += 1;
+        break;
+      case '--allow-dangerously-skip-permissions':
+        args.allowDangerouslySkipPermissions = true;
+        break;
+      case '--allowed-mcp-server-name':
+        args.allowedMcpServerNames.push(next);
+        index += 1;
+        break;
+      case '--mcp-config':
+        args.mcpConfig.push(next);
+        index += 1;
+        break;
+      case '--cwd':
+        args.cwd = next;
+        index += 1;
+        break;
+      default:
+        throw new Error(`Unknown argument: ${token}`);
+    }
+  }
+
+  if (!args.type) {
+    throw new Error('--type is required');
+  }
+
+  return args;
+}
+
+function parseJsonArray(raw, label) {
+  if (!raw) return [];
+  try {
+    const parsed = JSON.parse(raw);
+    if (!Array.isArray(parsed)) {
+      throw new Error(`${label} must be a JSON array`);
+    }
+    return parsed.map((item) => String(item));
+  } catch (error) {
+    throw new Error(`${label} parse failed: ${error.message}`);
+  }
+}
+
+function readPromptFromStdin() {
+  return readFileSync(0, 'utf8');
+}
+
+function resolveDefaultMcpConfig(cwd) {
+  const candidate = resolve(cwd, '.mcp.json');
+  return existsSync(candidate) ? [candidate] : [];
+}
+
+const args = parseArgs(process.argv.slice(2));
+const prompt = readPromptFromStdin();
+
+const worker = createWorker(args.type, {
+  command: args.command,
+  commandArgs: parseJsonArray(args.commandArgsJson, '--command-args-json'),
+  model: args.model,
+  timeoutMs: args.timeoutMs,
+  approvalMode: args.approvalMode,
+  permissionMode: args.permissionMode,
+  allowDangerouslySkipPermissions: args.allowDangerouslySkipPermissions,
+  allowedMcpServerNames: args.allowedMcpServerNames,
+  mcpConfig: args.type === 'claude' && args.mcpConfig.length === 0
+    ? resolveDefaultMcpConfig(args.cwd || process.cwd())
+    : args.mcpConfig,
+  cwd: args.cwd || process.cwd(),
+});
+
+try {
+  const result = await worker.run(prompt);
+  if (result.response) {
+    process.stdout.write(result.response);
+    if (!result.response.endsWith('\n')) process.stdout.write('\n');
+  }
+} catch (error) {
+  if (error.stderr) {
+    process.stderr.write(String(error.stderr));
+    if (!String(error.stderr).endsWith('\n')) process.stderr.write('\n');
+  }
+  process.stderr.write(`${error.message}\n`);
+  process.exitCode = error.code === 'ETIMEDOUT' ? 124 : 1;
+} finally {
+  try { await worker.stop(); } catch {}
+}