triflux 7.3.2 → 7.5.0

package/scripts/preflight-cache.mjs

@@ -1,137 +1,137 @@
-#!/usr/bin/env node
-// scripts/preflight-cache.mjs — 세션 시작 시 preflight 점검 캐싱
-
-import { writeFileSync, mkdirSync, existsSync, readFileSync } from "node:fs";
-import { join, dirname } from "node:path";
-import { homedir } from "node:os";
-import { execSync, spawn } from "node:child_process";
-import { fileURLToPath } from "node:url";
-
-const __filename = fileURLToPath(import.meta.url);
-const PKG_ROOT = join(dirname(__filename), "..");
-
-// 동기 대기 (Atomics.wait — Node.js main thread에서 사용 가능)
-const _sab = new Int32Array(new SharedArrayBuffer(4));
-function sleepSync(ms) { Atomics.wait(_sab, 0, 0, ms); }
-
-const CACHE_DIR = join(homedir(), ".claude", "cache");
-const CACHE_FILE = join(CACHE_DIR, "tfx-preflight.json");
-const CACHE_TTL_MS = 30_000; // 30초
-
-function checkHub() {
-  // 1차 시도
-  try {
-    const res = execSync("curl -sf http://127.0.0.1:27888/status", { timeout: 3000, encoding: "utf8", windowsHide: true });
-    const data = JSON.parse(res);
-    return { ok: true, state: data?.hub?.state || "unknown", pid: data?.pid };
-  } catch {}
-
-  // Hub 미응답 → 자동 재시작 시도 (bridge.mjs tryRestartHub 동기 버전)
-  const serverPath = join(PKG_ROOT, "hub", "server.mjs");
-  if (!existsSync(serverPath)) return { ok: false, state: "unreachable", restart: "no_server" };
-
-  try {
-    const child = spawn(process.execPath, [serverPath], {
-      detached: true,
-      stdio: "ignore",
-      windowsHide: true,
-    });
-    child.unref();
-  } catch {
-    return { ok: false, state: "unreachable", restart: "spawn_failed" };
-  }
-
-  // 최대 4초 폴링 (500ms × 8)
-  for (let i = 0; i < 8; i++) {
-    sleepSync(500);
-    try {
-      const res = execSync("curl -sf http://127.0.0.1:27888/status", { timeout: 1000, encoding: "utf8", windowsHide: true });
-      const data = JSON.parse(res);
-      if (data?.hub?.state === "healthy") {
-        return { ok: true, state: "healthy", pid: data?.pid, restarted: true };
-      }
-    } catch {}
-  }
-
-  return { ok: false, state: "unreachable", restart: "timeout" };
-}
-
-function checkRoute() {
-  const routePath = join(homedir(), ".claude", "scripts", "tfx-route.sh");
-  return { ok: existsSync(routePath), path: routePath };
-}
-
-function checkCli(name) {
-  try {
-    const path = execSync(`which ${name} 2>/dev/null || where ${name} 2>nul`, { encoding: "utf8", timeout: 2000, windowsHide: true }).trim();
-    return { ok: !!path, path };
-  } catch {
-    return { ok: false };
-  }
-}
-
-/** Codex auth.json의 JWT에서 chatgpt_plan_type 추출 (pro/plus/free) */
-function detectCodexPlan() {
-  try {
-    const authPath = join(homedir(), ".codex", "auth.json");
-    if (!existsSync(authPath)) return { plan: "unknown", source: "no_auth" };
-    const auth = JSON.parse(readFileSync(authPath, "utf8"));
-    if (auth.auth_mode !== "chatgpt") return { plan: "api", source: "api_key" };
-    const token = auth.tokens?.id_token || auth.tokens?.access_token;
-    if (!token) return { plan: "unknown", source: "no_token" };
-    // JWT payload = 2번째 파트, base64url 디코딩
-    const payload = JSON.parse(Buffer.from(token.split(".")[1], "base64url").toString());
-    const plan = payload?.["https://api.openai.com/auth"]?.chatgpt_plan_type || "unknown";
-    return { plan, source: "jwt" };
-  } catch {
-    return { plan: "unknown", source: "error" };
-  }
-}
-
-function runPreflight() {
-  const result = {
-    timestamp: Date.now(),
-    hub: checkHub(),
-    route: checkRoute(),
-    codex: checkCli("codex"),
-    gemini: checkCli("gemini"),
-    codex_plan: detectCodexPlan(),
-    ok: false,
-  };
-  result.ok = result.hub.ok && result.route.ok;
-
-  // CLI 가용성 → available_agents (triage에서 참조)
-  const agents = [];
-  if (result.codex.ok) agents.push("codex");
-  if (result.gemini.ok) agents.push("gemini");
-  agents.push("claude"); // claude는 항상 가용
-  result.available_agents = agents;
-
-  return result;
-}
-
-// 캐시 읽기 (TTL 검증 포함)
-export function readPreflightCache() {
-  try {
-    const data = JSON.parse(readFileSync(CACHE_FILE, "utf8"));
-    if (Date.now() - data.timestamp < CACHE_TTL_MS) return data;
-  } catch {}
-  return null;
-}
-
-// 메인 실행
-if (process.argv[1]?.endsWith("preflight-cache.mjs")) {
-  const result = runPreflight();
-  mkdirSync(CACHE_DIR, { recursive: true });
-  writeFileSync(CACHE_FILE, JSON.stringify(result, null, 2));
-  // 간결 출력 (hook stdout)
-  const summary = result.ok ? "preflight: ok" : "preflight: FAIL";
-  const details = [];
-  if (!result.hub.ok) details.push("hub:" + result.hub.state);
-  else if (result.hub.restarted) details.push("hub:restarted");
-  if (!result.route.ok) details.push("route:missing");
-  if (result.available_agents.length === 1) details.push("agents:claude-only");
-  console.log(details.length ? `${summary} (${details.join(", ")})` : summary);
-}
-
-export { runPreflight, CACHE_FILE, CACHE_TTL_MS };
+#!/usr/bin/env node
+// scripts/preflight-cache.mjs — 세션 시작 시 preflight 점검 캐싱
+
+import { writeFileSync, mkdirSync, existsSync, readFileSync } from "node:fs";
+import { join, dirname } from "node:path";
+import { homedir } from "node:os";
+import { execSync, spawn } from "node:child_process";
+import { fileURLToPath } from "node:url";
+
+const __filename = fileURLToPath(import.meta.url);
+const PKG_ROOT = join(dirname(__filename), "..");
+
+// 동기 대기 (Atomics.wait — Node.js main thread에서 사용 가능)
+const _sab = new Int32Array(new SharedArrayBuffer(4));
+function sleepSync(ms) { Atomics.wait(_sab, 0, 0, ms); }
+
+const CACHE_DIR = join(homedir(), ".claude", "cache");
+const CACHE_FILE = join(CACHE_DIR, "tfx-preflight.json");
+const CACHE_TTL_MS = 30_000; // 30초
+
+function checkHub() {
+  // 1차 시도
+  try {
+    const res = execSync("curl -sf http://127.0.0.1:27888/status", { timeout: 3000, encoding: "utf8", windowsHide: true });
+    const data = JSON.parse(res);
+    return { ok: true, state: data?.hub?.state || "unknown", pid: data?.pid };
+  } catch {}
+
+  // Hub 미응답 → 자동 재시작 시도 (bridge.mjs tryRestartHub 동기 버전)
+  const serverPath = join(PKG_ROOT, "hub", "server.mjs");
+  if (!existsSync(serverPath)) return { ok: false, state: "unreachable", restart: "no_server" };
+
+  try {
+    const child = spawn(process.execPath, [serverPath], {
+      detached: true,
+      stdio: "ignore",
+      windowsHide: true,
+    });
+    child.unref();
+  } catch {
+    return { ok: false, state: "unreachable", restart: "spawn_failed" };
+  }
+
+  // 최대 4초 폴링 (500ms × 8)
+  for (let i = 0; i < 8; i++) {
+    sleepSync(500);
+    try {
+      const res = execSync("curl -sf http://127.0.0.1:27888/status", { timeout: 1000, encoding: "utf8", windowsHide: true });
+      const data = JSON.parse(res);
+      if (data?.hub?.state === "healthy") {
+        return { ok: true, state: "healthy", pid: data?.pid, restarted: true };
+      }
+    } catch {}
+  }
+
+  return { ok: false, state: "unreachable", restart: "timeout" };
+}
+
+function checkRoute() {
+  const routePath = join(homedir(), ".claude", "scripts", "tfx-route.sh");
+  return { ok: existsSync(routePath), path: routePath };
+}
+
+function checkCli(name) {
+  try {
+    const path = execSync(`which ${name} 2>/dev/null || where ${name} 2>nul`, { encoding: "utf8", timeout: 2000, windowsHide: true }).trim();
+    return { ok: !!path, path };
+  } catch {
+    return { ok: false };
+  }
+}
+
+/** Codex auth.json의 JWT에서 chatgpt_plan_type 추출 (pro/plus/free) */
+function detectCodexPlan() {
+  try {
+    const authPath = join(homedir(), ".codex", "auth.json");
+    if (!existsSync(authPath)) return { plan: "unknown", source: "no_auth" };
+    const auth = JSON.parse(readFileSync(authPath, "utf8"));
+    if (auth.auth_mode !== "chatgpt") return { plan: "api", source: "api_key" };
+    const token = auth.tokens?.id_token || auth.tokens?.access_token;
+    if (!token) return { plan: "unknown", source: "no_token" };
+    // JWT payload = 2번째 파트, base64url 디코딩
+    const payload = JSON.parse(Buffer.from(token.split(".")[1], "base64url").toString());
+    const plan = payload?.["https://api.openai.com/auth"]?.chatgpt_plan_type || "unknown";
+    return { plan, source: "jwt" };
+  } catch {
+    return { plan: "unknown", source: "error" };
+  }
+}
+
+function runPreflight() {
+  const result = {
+    timestamp: Date.now(),
+    hub: checkHub(),
+    route: checkRoute(),
+    codex: checkCli("codex"),
+    gemini: checkCli("gemini"),
+    codex_plan: detectCodexPlan(),
+    ok: false,
+  };
+  result.ok = result.hub.ok && result.route.ok;
+
+  // CLI 가용성 → available_agents (triage에서 참조)
+  const agents = [];
+  if (result.codex.ok) agents.push("codex");
+  if (result.gemini.ok) agents.push("gemini");
+  agents.push("claude"); // claude는 항상 가용
+  result.available_agents = agents;
+
+  return result;
+}
+
+// 캐시 읽기 (TTL 검증 포함)
+export function readPreflightCache() {
+  try {
+    const data = JSON.parse(readFileSync(CACHE_FILE, "utf8"));
+    if (Date.now() - data.timestamp < CACHE_TTL_MS) return data;
+  } catch {}
+  return null;
+}
+
+// 메인 실행
+if (process.argv[1]?.endsWith("preflight-cache.mjs")) {
+  const result = runPreflight();
+  mkdirSync(CACHE_DIR, { recursive: true });
+  writeFileSync(CACHE_FILE, JSON.stringify(result, null, 2));
+  // 간결 출력 (hook stdout)
+  const summary = result.ok ? "preflight: ok" : "preflight: FAIL";
+  const details = [];
+  if (!result.hub.ok) details.push("hub:" + result.hub.state);
+  else if (result.hub.restarted) details.push("hub:restarted");
+  if (!result.route.ok) details.push("route:missing");
+  if (result.available_agents.length === 1) details.push("agents:claude-only");
+  console.log(details.length ? `${summary} (${details.join(", ")})` : summary);
+}
+
+export { runPreflight, CACHE_FILE, CACHE_TTL_MS };

package/scripts/remote-spawn.mjs

@@ -0,0 +1,222 @@
+#!/usr/bin/env node
+// remote-spawn.mjs — 로컬/원격 Claude 세션 실행 유틸리티
+//
+// Usage:
+//   node remote-spawn.mjs --local [--dir <path>] [--prompt "..."] [--handoff <file>]
+//   node remote-spawn.mjs --host <ssh-host> [--dir <path>] [--prompt "..."] [--handoff <file>]
+
+import { execFileSync, spawn } from "child_process";
+import { readFileSync, existsSync, statSync } from "fs";
+import { resolve, join } from "path";
+import { homedir, platform } from "os";
+
+const MAX_HANDOFF_BYTES = 1 * 1024 * 1024; // 1 MB
+
+// ── 입력 검증 ──
+
+const SAFE_HOST_RE = /^[a-zA-Z0-9._-]+$/;
+const SAFE_DIR_RE = /^[a-zA-Z0-9_.~\/:\\-]+$/;
+
+function validateHost(host) {
+  if (!SAFE_HOST_RE.test(host)) {
+    console.error(`invalid host name: ${host}`);
+    process.exit(1);
+  }
+  return host;
+}
+
+function validateDir(dir) {
+  if (!SAFE_DIR_RE.test(dir)) {
+    console.error(`invalid directory path: ${dir}`);
+    process.exit(1);
+  }
+  return dir;
+}
+
+function shellQuote(s) {
+  return "'" + s.replace(/'/g, "'\\''") + "'";
+}
+
+// ── CLI 파싱 ──
+
+function parseArgs(argv) {
+  const args = { host: null, dir: null, prompt: null, handoff: null, local: false };
+  for (let i = 2; i < argv.length; i++) {
+    const a = argv[i];
+    if (a === "--local") { args.local = true; continue; }
+    if (a === "--host" && argv[i + 1]) { args.host = validateHost(argv[++i]); continue; }
+    if (a === "--dir" && argv[i + 1]) { args.dir = validateDir(argv[++i]); continue; }
+    if (a === "--prompt" && argv[i + 1]) { args.prompt = argv[++i]; continue; }
+    if (a === "--handoff" && argv[i + 1]) { args.handoff = argv[++i]; continue; }
+    // 미지정 인자는 prompt로 처리
+    if (!args.prompt) args.prompt = a;
+  }
+  return args;
+}
+
+// ── Claude 실행 경로 감지 ──
+
+function detectClaudePath() {
+  // 1. 환경변수 오버라이드
+  if (process.env.CLAUDE_BIN_PATH) return process.env.CLAUDE_BIN_PATH;
+
+  // 2. WinGet Links
+  const wingetPath = join(homedir(), "AppData", "Local", "Microsoft", "WinGet", "Links", "claude.exe");
+  if (existsSync(wingetPath)) return wingetPath;
+
+  // 3. npm global
+  const npmPath = join(process.env.APPDATA || "", "npm", "claude.cmd");
+  if (existsSync(npmPath)) return npmPath;
+
+  // 3. PATH에서 찾기
+  try {
+    const cmd = platform() === "win32" ? "where" : "which";
+    const result = execFileSync(cmd, ["claude"], { encoding: "utf8", timeout: 5000 }).trim();
+    if (result) return result.split("\n")[0].trim();
+  } catch { /* not found */ }
+
+  return "claude"; // fallback — PATH에 있다고 가정
+}
+
+// ── 권한 플래그 ──
+
+function getPermissionFlag() {
+  if (process.env.TFX_CLAUDE_SAFE_MODE === "1") return [];
+  return ["--PLACEHOLDER_PERM_FLAG"];
+}
+
+// ── 핸드오프 컨텐츠 생성 ──
+
+function buildPrompt(args) {
+  let content = "";
+
+  if (args.handoff) {
+    const handoffPath = resolve(args.handoff);
+    if (!existsSync(handoffPath)) {
+      console.error(`handoff file not found: ${handoffPath}`);
+      process.exit(1);
+    }
+    const size = statSync(handoffPath).size;
+    if (size > MAX_HANDOFF_BYTES) {
+      console.error(`handoff file too large: ${size} bytes (max ${MAX_HANDOFF_BYTES})`);
+      process.exit(1);
+    }
+    content = readFileSync(handoffPath, "utf8").trim();
+  }
+
+  if (args.prompt) {
+    content = content ? `${content}\n\n---\n\n${args.prompt}` : args.prompt;
+  }
+
+  return content;
+}
+
+// ── 로컬 Spawn (WT 탭) ──
+
+function spawnLocal(args, claudePath, prompt) {
+  const dir = args.dir ? resolve(args.dir) : process.cwd();
+
+  if (platform() !== "win32") {
+    // Linux/macOS: 직접 실행
+    const cliArgs = [...getPermissionFlag()];
+    if (prompt) cliArgs.push(prompt);
+
+    const child = spawn(claudePath, cliArgs, {
+      cwd: dir,
+      stdio: "inherit",
+    });
+    child.on("exit", (code) => process.exit(code || 0));
+    return;
+  }
+
+  // Windows: wt.exe new-tab
+  const wtArgs = ["new-tab", "-d", dir, "--"];
+  const claudeForward = claudePath.replace(/\\/g, "/");
+
+  if (prompt) {
+    // pwsh single-quote: 내부 ' → '' 이스케이프
+    const psQuoted = "'" + prompt.replace(/'/g, "''") + "'";
+    wtArgs.push(
+      "pwsh", "-NoProfile", "-Command",
+      `& '${claudeForward}' ${getPermissionFlag().join(" ")} ${psQuoted}`,
+    );
+  } else {
+    wtArgs.push(claudeForward, ...getPermissionFlag());
+  }
+
+  try {
+    spawn("wt.exe", wtArgs, { detached: true, stdio: "ignore", windowsHide: false }).unref();
+    console.log(`spawned local Claude in WT tab → ${dir}`);
+  } catch (err) {
+    console.error("wt.exe spawn failed:", err.message);
+    process.exit(1);
+  }
+}
+
+// ── 원격 Spawn (SSH) ──
+
+function spawnRemote(args, prompt) {
+  const { host } = args;
+  if (!host) {
+    console.error("--host required for remote spawn");
+    process.exit(1);
+  }
+
+  const dir = args.dir || "~";
+  const quotedDir = shellQuote(dir);
+  const permFlag = getPermissionFlag().join(" ");
+  const remoteCmd = prompt
+    ? `cd ${quotedDir} && claude ${permFlag} ${shellQuote(prompt)}`
+    : `cd ${quotedDir} && claude ${permFlag}`;
+
+  if (platform() === "win32") {
+    // WT 탭에서 SSH 세션 열기
+    const wtArgs = [
+      "new-tab", "--title", `Claude@${host}`, "--",
+      "ssh", "-t", "--", host, remoteCmd,
+    ];
+
+    try {
+      spawn("wt.exe", wtArgs, { detached: true, stdio: "ignore", windowsHide: false }).unref();
+      console.log(`spawned remote Claude → ${host}:${dir}`);
+    } catch (err) {
+      console.error("wt.exe spawn failed:", err.message);
+      process.exit(1);
+    }
+  } else {
+    // Linux/macOS: 직접 SSH
+    const child = spawn("ssh", ["-t", "--", host, remoteCmd], { stdio: "inherit" });
+    child.on("exit", (code) => process.exit(code || 0));
+  }
+}
+
+// ── main ──
+
+function main() {
+  const args = parseArgs(process.argv);
+
+  if (!args.local && !args.host) {
+    console.log(`Usage:
+  remote-spawn --local [--dir <path>] [--prompt "task"] [--handoff <file>]
+  remote-spawn --host <ssh-host> [--dir <path>] [--prompt "task"] [--handoff <file>]
+
+Options:
+  --local          로컬 WT 탭에서 Claude 실행
+  --host <name>    SSH 호스트로 원격 Claude 실행
+  --dir <path>     작업 디렉토리 (기본: 현재 디렉토리 / ~)
+  --prompt "..."   Claude에 전달할 첫 메시지
+  --handoff <file> 핸드오프 파일 경로 (prompt와 결합 가능)`);
+    process.exit(0);
+  }
+
+  const prompt = buildPrompt(args);
+  const claudePath = detectClaudePath();
+
+  if (args.local) {
+    spawnLocal(args, claudePath, prompt);
+  } else {
+    spawnRemote(args, prompt);
+  }
+}
+
+main();

package/scripts/setup.mjs

@@ -30,6 +30,20 @@ function detectDevMode(root = PLUGIN_ROOT) {
 const BREADCRUMB_PATH = join(CLAUDE_DIR, "scripts", ".tfx-pkg-root");
 
 const REQUIRED_CODEX_PROFILES = [
+  {
+    name: "fast",
+    lines: [
+      'model = "gpt-5.3-codex"',
+      'model_reasoning_effort = "low"',
+    ],
+  },
+  {
+    name: "normal",
+    lines: [
+      'model = "gpt-5.3-codex"',
+      'model_reasoning_effort = "medium"',
+    ],
+  },
   {
     name: "high",
     lines: [
@@ -37,6 +51,14 @@ const REQUIRED_CODEX_PROFILES = [
       'model_reasoning_effort = "high"',
     ],
   },
+  {
+    name: "thorough",
+    lines: [
+      'model = "gpt-5.3-codex"',
+      'model_reasoning_effort = "high"',
+      'model_temperature = 0.2',
+    ],
+  },
   {
     name: "xhigh",
     lines: [
@@ -51,6 +73,13 @@ const REQUIRED_CODEX_PROFILES = [
       'model_reasoning_effort = "low"',
     ],
   },
+  {
+    name: "spark_balanced",
+    lines: [
+      'model = "gpt-5.1-codex-mini"',
+      'model_reasoning_effort = "medium"',
+    ],
+  },
 ];
 
 // ── 파일 동기화 ──
@@ -186,6 +215,16 @@ const SYNC_MAP = [
     dst: join(CLAUDE_DIR, "scripts", "headless-guard-fast.sh"),
     label: "headless-guard-fast.sh",
   },
+  {
+    src: join(PLUGIN_ROOT, "scripts", "tfx-gate-activate.mjs"),
+    dst: join(CLAUDE_DIR, "scripts", "tfx-gate-activate.mjs"),
+    label: "tfx-gate-activate.mjs",
+  },
+  {
+    src: join(PLUGIN_ROOT, "scripts", "remote-spawn.mjs"),
+    dst: join(CLAUDE_DIR, "scripts", "remote-spawn.mjs"),
+    label: "remote-spawn.mjs",
+  },
 ];
 
 function getVersion(filePath) {
@@ -454,6 +493,19 @@ function applyAgentTeams(s) {
   return changed;
 }
 
+/**
+ * Remote Control 자동 활성화.
+ * 모든 세션에서 remote control URL을 자동 발급하도록 설정.
+ * @param {object} s - settings 객체 (직접 변경)
+ * @returns {boolean} 변경 여부
+ */
+function applyRemoteControl(s) {
+  if (s.remoteControlAtStartup === true) return false;
+  if (process.env.TFX_REMOTE_CONTROL !== "1" && !detectDevMode()) return false;
+  s.remoteControlAtStartup = true;
+  return true;
+}
+
 /**
  * SessionStart + PreToolUse 훅 섹션 적용.
  * @param {object} s - settings 객체 (직접 변경)
@@ -533,6 +585,37 @@ function applyHooks(s) {
     }
   }
 
+  // ── PreToolUse 훅: tfx-gate-activate (Skill 감지 → A+B gate) ──
+  const gateScriptPath = join(CLAUDE_DIR, "scripts", "tfx-gate-activate.mjs").replace(/\\/g, "/");
+  const hasGateHook = s.hooks.PreToolUse.some((entry) =>
+    Array.isArray(entry.hooks) &&
+    entry.hooks.some((h) => typeof h.command === "string" && h.command.includes("tfx-gate-activate")),
+  );
+
+  if (!hasGateHook && existsSync(gateScriptPath.replace(/\//g, "\\"))) {
+    s.hooks.PreToolUse.push({
+      matcher: "Skill",
+      hooks: [
+        {
+          type: "command",
+          command: `node "${gateScriptPath}"`,
+          timeout: 2,
+        },
+      ],
+    });
+    changed = true;
+  } else if (hasGateHook) {
+    for (const entry of s.hooks.PreToolUse) {
+      if (!Array.isArray(entry.hooks)) continue;
+      for (const h of entry.hooks) {
+        if (typeof h.command === "string" && h.command.includes("tfx-gate-activate") && !h.command.includes(gateScriptPath)) {
+          h.command = `node "${gateScriptPath}"`;
+          changed = true;
+        }
+      }
+    }
+  }
+
   return changed;
 }
 
@@ -546,6 +629,7 @@ if (existsSync(settingsPath)) {
 let settingsChanged = false;
 try { if (applyStatusLine(settings)) { settingsChanged = true; synced++; } } catch {}
 try { if (applyAgentTeams(settings)) { settingsChanged = true; synced++; } } catch {}
+try { if (applyRemoteControl(settings)) { settingsChanged = true; synced++; } } catch {}
 try { if (applyHooks(settings)) { settingsChanged = true; synced++; } } catch {}
 
 // 1회 쓰기
@@ -722,4 +806,3 @@ process.exit(0);
 if (process.argv[1] && fileURLToPath(import.meta.url) === process.argv[1]) {
   main();
 }
-