triflux 10.3.4 → 10.7.0

package/scripts/test-lock.mjs

@@ -1,4 +1,5 @@
 #!/usr/bin/env node
+
 // scripts/test-lock.mjs — 테스트 러너 싱글톤 lockfile 가드
 //
 // npm test 동시 실행 방지. conductor 같은 child-spawn 테스트가
@@ -6,9 +7,9 @@
 //
 // 사용: node scripts/test-lock.mjs [-- ...node --test args]
 
-import { writeFileSync, readFileSync, unlinkSync, mkdirSync } from "node:fs";
-import { join } from "node:path";
 import { spawn } from "node:child_process";
+import { mkdirSync, readFileSync, unlinkSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
 
 const LOCK_DIR = join(import.meta.dirname, "..", ".test-lock");
 const LOCK_FILE = join(LOCK_DIR, "pid.lock");
@@ -31,8 +32,12 @@ function acquireLock() {
     // Windows에서 process.kill(pid,0)이 git-bash PID를 못 잡음.
     // 단순하게: lockfile이 있고 STALE_THRESHOLD 이내면 거부.
     if (age >= 0 && age < STALE_THRESHOLD_MS) {
-      console.error(`\x1b[31m✗ 테스트 이미 실행 중 (PID ${existing.pid}, ${Math.round(age / 1000)}초 전 시작)\x1b[0m`);
-      console.error(`  동시 실행은 WT 메모리 폭발을 유발합니다. 기다리거나 PID를 kill하세요.`);
+      console.error(
+        `\x1b[31m✗ 테스트 이미 실행 중 (PID ${existing.pid}, ${Math.round(age / 1000)}초 전 시작)\x1b[0m`,
+      );
+      console.error(
+        `  동시 실행은 WT 메모리 폭발을 유발합니다. 기다리거나 PID를 kill하세요.`,
+      );
       console.error(`  강제 해제: rm ${LOCK_FILE}`);
       process.exit(1);
     }
@@ -46,7 +51,9 @@ function releaseLock() {
   try {
     const lock = readLock();
     if (lock && lock.pid === process.pid) unlinkSync(LOCK_FILE);
-  } catch { /* ignore */ }
+  } catch {
+    /* ignore */
+  }
 }
 
 // ── main ──
@@ -55,8 +62,14 @@ acquireLock();
 
 // cleanup on exit
 process.on("exit", releaseLock);
-process.on("SIGINT", () => { releaseLock(); process.exit(130); });
-process.on("SIGTERM", () => { releaseLock(); process.exit(143); });
+process.on("SIGINT", () => {
+  releaseLock();
+  process.exit(130);
+});
+process.on("SIGTERM", () => {
+  releaseLock();
+  process.exit(143);
+});
 
 // forward args after -- to node --test
 const args = process.argv.slice(2);

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

@@ -1,8 +1,8 @@
 #!/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 test from "node:test";
 import { fileURLToPath } from "node:url";
 
 const SCRIPT_DIR = dirname(fileURLToPath(import.meta.url));
@@ -14,13 +14,13 @@ function runBash(command) {
     encoding: "utf8",
     env: {
       ...process.env,
-      TFX_TEAM_NAME: '',
-      TFX_TEAM_TASK_ID: '',
-      TFX_TEAM_AGENT_NAME: '',
-      TFX_TEAM_LEAD_NAME: '',
-      TFX_HUB_URL: '',
-      TMUX: '',
-    }
+      TFX_TEAM_NAME: "",
+      TFX_TEAM_TASK_ID: "",
+      TFX_TEAM_AGENT_NAME: "",
+      TFX_TEAM_LEAD_NAME: "",
+      TFX_HUB_URL: "",
+      TMUX: "",
+    },
   });
 }
 
@@ -30,7 +30,7 @@ function out(result) {
 
 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'"
+    "TFX_CLI_MODE=gemini TFX_NO_CLAUDE_NATIVE=1 bash scripts/tfx-route.sh explore 'test-case'",
   );
 
   assert.equal(result.status, 0, out(result));
@@ -39,17 +39,21 @@ test("gemini 모드에서는 no-claude-native 강제 치환이 적용되지 않
 
 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"
+    "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),
+    /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'"
+    "TFX_NO_CLAUDE_NATIVE=2 bash scripts/tfx-route.sh explore 'test-case'",
   );
 
   assert.notEqual(result.status, 0, out(result));

package/scripts/tfx-batch-stats.mjs

@@ -11,8 +11,8 @@
 //   node tfx-batch-stats.mjs agent <name>          특정 에이전트 통계
 
 import { readFileSync } from "node:fs";
-import { join } from "node:path";
 import { homedir } from "node:os";
+import { join } from "node:path";
 
 const CACHE_DIR = join(homedir(), ".claude", "cache");
 const EVENTS_FILE = join(CACHE_DIR, "batch-events.jsonl");
@@ -21,18 +21,30 @@ const EVENTS_FILE = join(CACHE_DIR, "batch-events.jsonl");
 const AIMD_INITIAL = 3;
 const AIMD_MIN = 1;
 const AIMD_MAX = 10;
-const AIMD_INC = 1;        // 성공 시 +1
-const AIMD_DEC = 0.5;      // 실패 시 ×0.5
+const AIMD_INC = 1; // 성공 시 +1
+const AIMD_DEC = 0.5; // 실패 시 ×0.5
 const WINDOW_MS = 30 * 60 * 1000; // 30분 윈도우
 
 // ── 이벤트 읽기 ──
 export function readBatchEvents(opts = {}) {
   const { sinceMs = 0, agent = null } = opts;
   try {
-    const lines = readFileSync(EVENTS_FILE, "utf-8").trim().split("\n").filter(Boolean);
+    const lines = readFileSync(EVENTS_FILE, "utf-8")
+      .trim()
+      .split("\n")
+      .filter(Boolean);
     return lines
-      .map((l) => { try { return JSON.parse(l); } catch { return null; } })
-      .filter((e) => e && (!sinceMs || e.ts >= sinceMs) && (!agent || e.agent === agent));
+      .map((l) => {
+        try {
+          return JSON.parse(l);
+        } catch {
+          return null;
+        }
+      })
+      .filter(
+        (e) =>
+          e && (!sinceMs || e.ts >= sinceMs) && (!agent || e.agent === agent),
+      );
   } catch {
     return [];
   }
@@ -44,9 +56,11 @@ export function getAgentStats(opts = {}) {
   const stats = {};
 
   for (const ev of events) {
-    if (!stats[ev.agent]) stats[ev.agent] = { success: 0, fail: 0, timeout: 0, total: 0 };
+    if (!stats[ev.agent])
+      stats[ev.agent] = { success: 0, fail: 0, timeout: 0, total: 0 };
     const s = stats[ev.agent];
-    if (ev.result === "success" || ev.result === "success_with_warnings") s.success++;
+    if (ev.result === "success" || ev.result === "success_with_warnings")
+      s.success++;
     else if (ev.result === "timeout") s.timeout++;
     else s.fail++;
     s.total++;
@@ -85,11 +99,18 @@ if (scriptName.endsWith("tfx-batch-stats.mjs")) {
   const sinceMs = recent ? Date.now() - WINDOW_MS : 0;
 
   if (cmd === "batch") {
-    console.log(JSON.stringify({ batchSize: getAimdBatchSize(), window: "30m" }));
+    console.log(
+      JSON.stringify({ batchSize: getAimdBatchSize(), window: "30m" }),
+    );
   } else if (cmd === "agent") {
     const name = process.argv[3];
-    if (!name) { console.error("에이전트명 필수: node tfx-batch-stats.mjs agent executor"); process.exit(1); }
-    console.log(JSON.stringify(getAgentStats({ sinceMs, agent: name }), null, 2));
+    if (!name) {
+      console.error("에이전트명 필수: node tfx-batch-stats.mjs agent executor");
+      process.exit(1);
+    }
+    console.log(
+      JSON.stringify(getAgentStats({ sinceMs, agent: name }), null, 2),
+    );
   } else {
     console.log(JSON.stringify(getAgentStats({ sinceMs }), null, 2));
   }

package/scripts/tfx-gate-activate.mjs

@@ -9,7 +9,7 @@
  * 자동 만료: 30분
  */
 
-import { writeFileSync, existsSync, readFileSync } from "node:fs";
+import { existsSync, readFileSync, writeFileSync } from "node:fs";
 import { tmpdir } from "node:os";
 import { join } from "node:path";
 
@@ -42,15 +42,22 @@ async function main() {
 
   // 모든 tfx CLI 라우팅 스킬에 gate 적용
   const TFX_ROUTING_SKILLS = new Set([
-    "tfx-multi", "tfx-team", "tfx-auto", "tfx-auto-codex",
-    "tfx-codex", "tfx-gemini", "tfx-autoresearch",
+    "tfx-multi",
+    "tfx-team",
+    "tfx-auto",
+    "tfx-auto-codex",
+    "tfx-codex",
+    "tfx-gemini",
+    "tfx-autoresearch",
   ]);
 
   if (TFX_ROUTING_SKILLS.has(skill)) {
     // 활성화: 상태 파일 생성/갱신
+    // ppid = Claude Code 세션 PID (훅은 Claude Code의 자식 프로세스)
     const state = {
       active: true,
       activatedAt: Date.now(),
+      ownerPid: process.ppid,
       dispatched: false,
       nativeWorkCalls: 0,
       nativeWorkCallsSinceDispatch: 0,
@@ -64,7 +71,7 @@ async function main() {
           hookEventName: "PreToolUse",
           additionalContext:
             "[tfx-multi] gate 활성화됨. CLI 작업은 headless로 dispatch 필수:\n" +
-            'Bash("tfx multi --teammate-mode headless --auto-attach --dashboard --assign \'codex:프롬프트:역할\' --timeout 600")',
+            "Bash(\"tfx multi --teammate-mode headless --auto-attach --dashboard --assign 'codex:프롬프트:역할' --timeout 600\")",
         },
       }),
     );

package/scripts/tfx-route-post.mjs

@@ -13,9 +13,17 @@
 //   6. CLI 이슈 자동 수집
 //   7. 구조화된 결과 출력 (=== TFX-ROUTE RESULT ===)
 
-import { readFileSync, writeFileSync, appendFileSync, existsSync, mkdirSync, readdirSync, statSync } from "fs";
-import { join } from "path";
+import {
+  appendFileSync,
+  existsSync,
+  mkdirSync,
+  readdirSync,
+  readFileSync,
+  statSync,
+  writeFileSync,
+} from "fs";
 import { homedir } from "os";
+import { join } from "path";
 
 const HOME = homedir();
 const CACHE_DIR = join(HOME, ".claude", "cache");
@@ -171,7 +179,10 @@ function extractCodexSessionId(rawOutput, stderrContent = "") {
 
 function appendCodexResumeHint(output, rawOutput, stderrContent = "") {
   const normalizedOutput = String(output || "").trim();
-  if (/Codex session ID:/i.test(normalizedOutput) || /codex resume\s+/i.test(normalizedOutput)) {
+  if (
+    /Codex session ID:/i.test(normalizedOutput) ||
+    /codex resume\s+/i.test(normalizedOutput)
+  ) {
     return normalizedOutput;
   }
 
@@ -184,7 +195,11 @@ function appendCodexResumeHint(output, rawOutput, stderrContent = "") {
   return normalizedOutput ? `${normalizedOutput}\n\n${hint}` : hint;
 }
 
-function prepareCliOutput(rawOutput, cliType, { cleanTui = true, stderrContent = "" } = {}) {
+function prepareCliOutput(
+  rawOutput,
+  cliType,
+  { cleanTui = true, stderrContent = "" } = {},
+) {
   let prepared = cliType === "codex" ? filterCodexOutput(rawOutput) : rawOutput;
   if (cleanTui && process.env.TFX_CLEAN_TUI !== "0") {
     prepared = cleanTuiArtifacts(prepared, cliType);
@@ -214,7 +229,9 @@ function cleanTuiArtifacts(output, cliType) {
       .replace(/^\s*codex\s*$/gm, "")
       .replace(/^[^\S\n]*[›❯]\s*Applied.*$/gm, "");
   } else if (normalizedCliType.startsWith("gemini")) {
-    cleaned = cleaned.replace(/^[^\S\n]*[╭╮╰╯│─═].*$/gm, "").replace(/^[^\S\n]*>\s*$/gm, "");
+    cleaned = cleaned
+      .replace(/^[^\S\n]*[╭╮╰╯│─═].*$/gm, "")
+      .replace(/^[^\S\n]*>\s*$/gm, "");
   } else if (normalizedCliType.startsWith("claude")) {
     cleaned = cleaned.replace(/^[^\S\n]*[━─]{5,}.*$/gm, "");
   }
@@ -285,7 +302,10 @@ function recordBatchEvent(result, agent) {
   const eventsFile = join(CACHE_DIR, "batch-events.jsonl");
   try {
     mkdirSync(CACHE_DIR, { recursive: true });
-    appendFileSync(eventsFile, JSON.stringify({ ts: Date.now(), agent, result }) + "\n");
+    appendFileSync(
+      eventsFile,
+      JSON.stringify({ ts: Date.now(), agent, result }) + "\n",
+    );
 
     // 자동 회전: 200줄 초과 시 최근 100줄 유지
     const content = readFileSync(eventsFile, "utf-8").trim();
@@ -301,12 +321,42 @@ function trackCliIssue(cliType, agent, stderrText, exitCode) {
   if (!stderrText && exitCode === 0) return;
 
   const patterns = [
-    { regex: /sandbox image.*missing/i, pattern: "sandbox_missing", msg: "Docker sandbox image not found", severity: "warn" },
-    { regex: /rate.limit|429|too many requests/i, pattern: "rate_limit", msg: "API rate limit exceeded", severity: "warn" },
-    { regex: /ECONNREFUSED|ENOTFOUND|network/i, pattern: "network_error", msg: "Network connection failed", severity: "error" },
-    { regex: /deprecated/i, pattern: "deprecated_flag", msg: "Deprecated flag/feature detected", severity: "warn" },
-    { regex: /API_KEY.*not.set|auth.*fail|unauthorized|401/i, pattern: "auth_error", msg: "Authentication failed", severity: "error" },
-    { regex: /ENOMEM|out of memory|heap/i, pattern: "oom", msg: "Out of memory", severity: "error" },
+    {
+      regex: /sandbox image.*missing/i,
+      pattern: "sandbox_missing",
+      msg: "Docker sandbox image not found",
+      severity: "warn",
+    },
+    {
+      regex: /rate.limit|429|too many requests/i,
+      pattern: "rate_limit",
+      msg: "API rate limit exceeded",
+      severity: "warn",
+    },
+    {
+      regex: /ECONNREFUSED|ENOTFOUND|network/i,
+      pattern: "network_error",
+      msg: "Network connection failed",
+      severity: "error",
+    },
+    {
+      regex: /deprecated/i,
+      pattern: "deprecated_flag",
+      msg: "Deprecated flag/feature detected",
+      severity: "warn",
+    },
+    {
+      regex: /API_KEY.*not.set|auth.*fail|unauthorized|401/i,
+      pattern: "auth_error",
+      msg: "Authentication failed",
+      severity: "error",
+    },
+    {
+      regex: /ENOMEM|out of memory|heap/i,
+      pattern: "oom",
+      msg: "Out of memory",
+      severity: "error",
+    },
   ];
 
   let matched = null;
@@ -318,7 +368,11 @@ function trackCliIssue(cliType, agent, stderrText, exitCode) {
   }
 
   if (!matched && exitCode !== 0 && exitCode !== 124) {
-    matched = { pattern: "unknown_error", msg: `Exit code ${exitCode}`, severity: "warn" };
+    matched = {
+      pattern: "unknown_error",
+      msg: `Exit code ${exitCode}`,
+      severity: "warn",
+    };
   }
 
   if (!matched) return;
@@ -329,21 +383,30 @@ function trackCliIssue(cliType, agent, stderrText, exitCode) {
 
     // 중복 방지: 같은 패턴+cli가 최근 5분 내 기록됐으면 건너뜀
     if (existsSync(issuesFile)) {
-      const lines = readFileSync(issuesFile, "utf-8").trim().split("\n").slice(-5);
+      const lines = readFileSync(issuesFile, "utf-8")
+        .trim()
+        .split("\n")
+        .slice(-5);
       const now = Date.now();
       for (const line of lines) {
         try {
           const entry = JSON.parse(line);
-          if (entry.pattern === matched.pattern && entry.cli === cliType && now - entry.ts < 300000) return;
+          if (
+            entry.pattern === matched.pattern &&
+            entry.cli === cliType &&
+            now - entry.ts < 300000
+          )
+            return;
         } catch {}
       }
     }
 
     const snippet = stderrText.substring(0, 200).replace(/\n/g, " ");
 
-    const retryCount = (matched.pattern === "rate_limit" && cliType === "gemini")
-      ? parseInt(process.env.TFX_GEMINI_429_RETRIES || "0", 10)
-      : undefined;
+    const retryCount =
+      matched.pattern === "rate_limit" && cliType === "gemini"
+        ? parseInt(process.env.TFX_GEMINI_429_RETRIES || "0", 10)
+        : undefined;
 
     const issueEntry = {
       ts: Date.now(),
@@ -440,7 +503,8 @@ function main() {
   if (exitCode === 0) accumulateTokens(cliType, tokens);
 
   // 5. AIMD 배치 이벤트
-  const aimdResult = exitCode === 0 ? "success" : exitCode === 124 ? "timeout" : "failed";
+  const aimdResult =
+    exitCode === 0 ? "success" : exitCode === 124 ? "timeout" : "failed";
   recordBatchEvent(aimdResult, agent);
 
   // 6. CLI 이슈 추적
@@ -462,7 +526,9 @@ function main() {
   if (exitCode === 0) {
     if (stderrContent) {
       console.log("status: success_with_warnings");
-      console.log(`warnings: ${stderrContent.split("\n").slice(0, 3).join(" ")}`);
+      console.log(
+        `warnings: ${stderrContent.split("\n").slice(0, 3).join(" ")}`,
+      );
     } else {
       console.log("status: success");
     }
@@ -498,6 +564,7 @@ function main() {
 }
 
 import { fileURLToPath } from "url";
+
 if (process.argv[1] && fileURLToPath(import.meta.url) === process.argv[1]) {
   main();
 }