triflux 10.0.0 → 10.0.2

package/scripts/test-lock.mjs

@@ -0,0 +1,71 @@
+#!/usr/bin/env node
+// scripts/test-lock.mjs — 테스트 러너 싱글톤 lockfile 가드
+//
+// npm test 동시 실행 방지. conductor 같은 child-spawn 테스트가
+// 3중 실행되면 WT ConPTY 수백 개 → 16GB RAM 사고 발생.
+//
+// 사용: node scripts/test-lock.mjs [-- ...node --test args]
+
+import { existsSync, writeFileSync, readFileSync, unlinkSync, mkdirSync } from "node:fs";
+import { join } from "node:path";
+import { spawn } from "node:child_process";
+
+const LOCK_DIR = join(import.meta.dirname, "..", ".test-lock");
+const LOCK_FILE = join(LOCK_DIR, "pid.lock");
+const STALE_THRESHOLD_MS = 10 * 60 * 1000; // 10분 넘으면 stale
+
+function readLock() {
+  try {
+    const content = readFileSync(LOCK_FILE, "utf8").trim();
+    const [pidStr, tsStr] = content.split("\n");
+    return { pid: Number(pidStr), ts: Number(tsStr) };
+  } catch {
+    return null;
+  }
+}
+
+function acquireLock() {
+  const existing = readLock();
+  if (existing) {
+    const age = Date.now() - existing.ts;
+    // 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(`  강제 해제: rm ${LOCK_FILE}`);
+      process.exit(1);
+    }
+    // stale (>10분) — 덮어쓰기
+  }
+  mkdirSync(LOCK_DIR, { recursive: true });
+  writeFileSync(LOCK_FILE, `${process.pid}\n${Date.now()}`, "utf8");
+}
+
+function releaseLock() {
+  try {
+    const lock = readLock();
+    if (lock && lock.pid === process.pid) unlinkSync(LOCK_FILE);
+  } catch { /* ignore */ }
+}
+
+// ── main ──
+
+acquireLock();
+
+// cleanup on exit
+process.on("exit", releaseLock);
+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);
+const child = spawn(process.execPath, args, {
+  stdio: "inherit",
+  env: { ...process.env, TEST_LOCK_PID: String(process.pid) },
+});
+
+child.on("exit", (code) => {
+  releaseLock();
+  process.exit(code ?? 1);
+});

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

@@ -0,0 +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));
+});

package/scripts/tfx-batch-stats.mjs

@@ -0,0 +1,96 @@
+#!/usr/bin/env node
+// tfx-batch-stats.mjs v1.0 — batch-events.jsonl 소비자
+//
+// tfx-route-post.mjs가 기록한 AIMD 이벤트를 읽어서:
+//   1. 에이전트별 성공/실패/타임아웃 통계 집계
+//   2. AIMD(Additive Increase / Multiplicative Decrease) batch_size 계산
+//
+// 사용법:
+//   node tfx-batch-stats.mjs stats [--recent]     에이전트별 통계 (--recent: 30분)
+//   node tfx-batch-stats.mjs batch                 현재 권장 batch_size
+//   node tfx-batch-stats.mjs agent <name>          특정 에이전트 통계
+
+import { readFileSync } from "node:fs";
+import { join } from "node:path";
+import { homedir } from "node:os";
+
+const CACHE_DIR = join(homedir(), ".claude", "cache");
+const EVENTS_FILE = join(CACHE_DIR, "batch-events.jsonl");
+
+// AIMD 파라미터
+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 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);
+    return lines
+      .map((l) => { try { return JSON.parse(l); } catch { return null; } })
+      .filter((e) => e && (!sinceMs || e.ts >= sinceMs) && (!agent || e.agent === agent));
+  } catch {
+    return [];
+  }
+}
+
+// ── 에이전트별 통계 ──
+export function getAgentStats(opts = {}) {
+  const events = readBatchEvents(opts);
+  const stats = {};
+
+  for (const ev of events) {
+    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++;
+    else if (ev.result === "timeout") s.timeout++;
+    else s.fail++;
+    s.total++;
+  }
+
+  for (const s of Object.values(stats)) {
+    s.successRate = s.total > 0 ? +(s.success / s.total).toFixed(2) : 0;
+  }
+
+  return { total: events.length, agents: stats };
+}
+
+// ── AIMD batch_size 계산 ──
+// 최근 윈도우 이벤트를 순회하며 성공 시 +1, 실패 시 ×0.5
+export function getAimdBatchSize() {
+  const since = Date.now() - WINDOW_MS;
+  const events = readBatchEvents({ sinceMs: since });
+  if (events.length === 0) return AIMD_INITIAL;
+
+  let batch = AIMD_INITIAL;
+  for (const ev of events) {
+    if (ev.result === "success" || ev.result === "success_with_warnings") {
+      batch = Math.min(AIMD_MAX, batch + AIMD_INC);
+    } else {
+      batch = Math.max(AIMD_MIN, Math.floor(batch * AIMD_DEC));
+    }
+  }
+  return batch;
+}
+
+// ── CLI 진입점 ──
+const scriptName = process.argv[1] || "";
+if (scriptName.endsWith("tfx-batch-stats.mjs")) {
+  const cmd = process.argv[2] || "stats";
+  const recent = process.argv.includes("--recent");
+  const sinceMs = recent ? Date.now() - WINDOW_MS : 0;
+
+  if (cmd === "batch") {
+    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));
+  } else {
+    console.log(JSON.stringify(getAgentStats({ sinceMs }), null, 2));
+  }
+}

package/scripts/tfx-gate-activate.mjs

@@ -0,0 +1,89 @@
+#!/usr/bin/env node
+/**
+ * tfx-multi-activate.mjs — PreToolUse(Skill) 훅
+ *
+ * /tfx-multi 스킬 호출을 감지하여 상태 파일을 설정한다.
+ * headless-guard.mjs가 이 상태를 읽어 A(gate) + B(nudge)를 수행.
+ *
+ * 상태 파일: $TMPDIR/tfx-multi-state.json
+ * 자동 만료: 30분
+ */
+
+import { writeFileSync, existsSync, readFileSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+
+const STATE_FILE = join(tmpdir(), "tfx-multi-state.json");
+const EXPIRE_MS = 30 * 60 * 1000; // 30분
+
+async function main() {
+  let raw = "";
+  for await (const chunk of process.stdin) raw += chunk;
+
+  if (!raw.trim()) {
+    process.exit(0);
+  }
+
+  let input;
+  try {
+    input = JSON.parse(raw);
+  } catch {
+    process.exit(0);
+  }
+
+  const toolName = input.tool_name || "";
+  const toolInput = input.tool_input || {};
+
+  if (toolName !== "Skill") {
+    process.exit(0);
+  }
+
+  const skill = (toolInput.skill || "").toLowerCase();
+
+  // 모든 tfx CLI 라우팅 스킬에 gate 적용
+  const TFX_ROUTING_SKILLS = new Set([
+    "tfx-multi", "tfx-team", "tfx-auto", "tfx-auto-codex",
+    "tfx-codex", "tfx-gemini", "tfx-autoresearch",
+  ]);
+
+  if (TFX_ROUTING_SKILLS.has(skill)) {
+    // 활성화: 상태 파일 생성/갱신
+    const state = {
+      active: true,
+      activatedAt: Date.now(),
+      dispatched: false,
+      nativeWorkCalls: 0,
+      nativeWorkCallsSinceDispatch: 0,
+    };
+    writeFileSync(STATE_FILE, JSON.stringify(state));
+
+    // additionalContext로 Lead에게 알림
+    process.stdout.write(
+      JSON.stringify({
+        hookSpecificOutput: {
+          hookEventName: "PreToolUse",
+          additionalContext:
+            "[tfx-multi] gate 활성화됨. CLI 작업은 headless로 dispatch 필수:\n" +
+            'Bash("tfx multi --teammate-mode headless --auto-attach --dashboard --assign \'codex:프롬프트:역할\' --timeout 600")',
+        },
+      }),
+    );
+    process.exit(0);
+  }
+
+  // /tfx-multi 외 스킬 호출 시: 기존 상태 만료 체크만
+  if (existsSync(STATE_FILE)) {
+    try {
+      const state = JSON.parse(readFileSync(STATE_FILE, "utf8"));
+      if (Date.now() - state.activatedAt > EXPIRE_MS) {
+        // 만료 → 삭제하지 않고 headless-guard가 처리
+      }
+    } catch {
+      /* ignore */
+    }
+  }
+
+  process.exit(0);
+}
+
+main().catch(() => process.exit(0));