triflux 9.7.13 → 9.8.0

package/hub/workers/interface.mjs

@@ -1,40 +1,40 @@
-// hub/workers/interface.mjs — Worker 공통 인터페이스 정의
-
-/**
- * 워커 실행 옵션
- * @typedef {object} WorkerExecuteOptions
- * @property {string} [cwd] - 워커 작업 디렉터리
- * @property {string} [sessionKey] - 내부 세션 키
- * @property {string} [threadId] - 외부에서 지정한 Codex threadId
- * @property {boolean} [resetSession] - 기존 세션을 무시하고 새 세션 시작 여부
- * @property {string} [model] - Codex 모델 이름
- * @property {string} [profile] - Codex 프로필 이름
- * @property {'untrusted'|'on-failure'|'on-request'|'never'} [approvalPolicy] - 승인 정책
- * @property {'read-only'|'workspace-write'|'danger-full-access'} [sandbox] - 샌드박스 정책
- * @property {Record<string, unknown>} [config] - 추가 Codex 설정
- * @property {string} [baseInstructions] - 기본 시스템 지침
- * @property {string} [developerInstructions] - 개발자 지침
- * @property {string} [compactPrompt] - 컴팩션 프롬프트
- * @property {number} [timeoutMs] - MCP 요청 타임아웃(ms)
- */
-
-/**
- * 워커 실행 결과
- * @typedef {object} WorkerResult
- * @property {string} output - 최종 텍스트 출력
- * @property {number} exitCode - 종료 코드(0=성공)
- * @property {string | null} [threadId] - Codex 세션 threadId
- * @property {string | null} [sessionKey] - 내부 세션 키
- * @property {unknown} [raw] - 원본 tool call 결과
- */
-
-/**
- * 공통 워커 인터페이스
- * @typedef {object} IWorker
- * @property {(prompt: string, opts?: WorkerExecuteOptions) => Promise<WorkerResult>} execute
- * @property {() => Promise<void>} start
- * @property {() => Promise<void>} stop
- * @property {() => boolean} isReady
- * @property {string} type - 'codex' | 'gemini' | 'claude' | 'delegator'
- */
-
+// hub/workers/interface.mjs — Worker 공통 인터페이스 정의
+
+/**
+ * 워커 실행 옵션
+ * @typedef {object} WorkerExecuteOptions
+ * @property {string} [cwd] - 워커 작업 디렉터리
+ * @property {string} [sessionKey] - 내부 세션 키
+ * @property {string} [threadId] - 외부에서 지정한 Codex threadId
+ * @property {boolean} [resetSession] - 기존 세션을 무시하고 새 세션 시작 여부
+ * @property {string} [model] - Codex 모델 이름
+ * @property {string} [profile] - Codex 프로필 이름
+ * @property {'untrusted'|'on-failure'|'on-request'|'never'} [approvalPolicy] - 승인 정책
+ * @property {'read-only'|'workspace-write'|'danger-full-access'} [sandbox] - 샌드박스 정책
+ * @property {Record<string, unknown>} [config] - 추가 Codex 설정
+ * @property {string} [baseInstructions] - 기본 시스템 지침
+ * @property {string} [developerInstructions] - 개발자 지침
+ * @property {string} [compactPrompt] - 컴팩션 프롬프트
+ * @property {number} [timeoutMs] - MCP 요청 타임아웃(ms)
+ */
+
+/**
+ * 워커 실행 결과
+ * @typedef {object} WorkerResult
+ * @property {string} output - 최종 텍스트 출력
+ * @property {number} exitCode - 종료 코드(0=성공)
+ * @property {string | null} [threadId] - Codex 세션 threadId
+ * @property {string | null} [sessionKey] - 내부 세션 키
+ * @property {unknown} [raw] - 원본 tool call 결과
+ */
+
+/**
+ * 공통 워커 인터페이스
+ * @typedef {object} IWorker
+ * @property {(prompt: string, opts?: WorkerExecuteOptions) => Promise<WorkerResult>} execute
+ * @property {() => Promise<void>} start
+ * @property {() => Promise<void>} stop
+ * @property {() => boolean} isReady
+ * @property {string} type - 'codex' | 'gemini' | 'claude' | 'delegator'
+ */
+

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "triflux",
-  "version": "9.7.13",
+  "version": "9.8.0",
   "description": "CLI-first multi-model orchestrator for Claude Code — route tasks to Codex, Gemini, and Claude",
   "type": "module",
   "bin": {

package/scripts/__tests__/remote-spawn-transfer.test.mjs

@@ -114,4 +114,4 @@ describe("remote-spawn transfer plan", () => {
     assert.deepEqual(plan.transfers, []);
     assert.equal(plan.stagedHandoffPath, null);
   });
-});
+});

package/scripts/cache-warmup.mjs

@@ -309,6 +309,7 @@ export function extractProjectMeta(options = {}) {
   if (existsSync(packageJsonPath)) {
     try {
       const pkg = JSON.parse(readFileSync(packageJsonPath, "utf8"));
+      name = pkg.name || name;
       description = pkg.description || "";
       testCmd = pkg.scripts?.test || null;
       lang = "JavaScript/ESM (Node.js)";

package/scripts/claude-logged.ps1

@@ -0,0 +1,54 @@
+param(
+    [Parameter(ValueFromRemainingArguments=$true)]
+    [string[]]$ClaudeArgs
+)
+
+$LogDir  = "$HOME\Desktop\Projects\triflux\logs"
+$LogFile = "$LogDir\claude-sessions.log"
+
+if (-not (Test-Path $LogDir)) {
+    New-Item -ItemType Directory -Force -Path $LogDir | Out-Null
+}
+
+function Write-Log {
+    param([string]$Level, [string]$Message)
+    $ts = Get-Date -Format "yyyy-MM-dd HH:mm:ss"
+    $line = "[$ts] [$Level] $Message"
+    Write-Host $line
+    Add-Content -Path $LogFile -Value $line -Encoding UTF8
+}
+
+$SessionId = "{0}-{1}" -f (Get-Date -Format "yyyyMMddHHmmss"), $PID
+
+Write-Log "INFO" "=== Claude Code 세션 시작 [ID: $SessionId] | 인자: $($ClaudeArgs -join " ") ==="
+
+$StartTime = Get-Date
+
+try {
+    if ($ClaudeArgs -and $ClaudeArgs.Count -gt 0) {
+        & claude @ClaudeArgs
+    } else {
+        & claude
+    }
+    $ExitCode = $LASTEXITCODE
+} catch {
+    $ExitCode = -1
+    Write-Log "ERROR" "Claude 실행 실패: $_"
+}
+
+$EndTime = Get-Date
+$Elapsed = [math]::Round(($EndTime - $StartTime).TotalSeconds, 1)
+
+$Reason = switch ($ExitCode) {
+    0       { "정상 종료" }
+    1       { "일반 오류" }
+    -1      { "실행 실패 (명령 없음)" }
+    default { "비정상 종료" }
+}
+
+if ($ExitCode -eq -1073741510) { $Reason = "사용자 인터럽트 (Ctrl+C)" }
+
+Write-Log "INFO" "세션 종료 | exit=$ExitCode | 실행시간=${Elapsed}s | 원인=$Reason"
+Write-Log "INFO" "=== Claude Code 세션 종료 [ID: $SessionId] ==="
+
+exit $ExitCode

package/scripts/demo-tui.mjs

@@ -0,0 +1,59 @@
+#!/usr/bin/env node
+// TUI 대시보드 데모 — 5초간 시뮬레이션 후 자동 종료
+import { createLogDashboard } from "../hub/team/tui.mjs";
+
+const tui = createLogDashboard({ refreshMs: 200, forceTTY: true });
+
+// Phase 1: 워커 시작
+tui.updateWorker("worker-1", {
+  cli: "codex", role: "executor", status: "running",
+  progress: 0.1, confidence: "low", tokens: "0.3k",
+  snapshot: "analyzing codebase...",
+  detail: "mcp: serena/activate_project started",
+});
+tui.updateWorker("worker-2", {
+  cli: "gemini", role: "writer", status: "running",
+  progress: 0.05, confidence: "low",
+  snapshot: "loading context...",
+  detail: "initializing gemini session",
+});
+
+// Phase 2: 진행
+setTimeout(() => {
+  tui.updateWorker("worker-1", {
+    progress: 0.45, tokens: "1.2k", confidence: "medium",
+    snapshot: "mcp: serena/read_file (completed)",
+    detail: "mcp: serena/activate_project (completed)\nmcp: serena/read_file started\nmcp: serena/read_file (completed)\nmcp: serena/find_symbol started",
+  });
+  tui.updateWorker("worker-2", {
+    progress: 0.3, tokens: "0.8k",
+    snapshot: "writing README section...",
+    detail: "initializing gemini session\nreading existing docs\nwriting README section...",
+  });
+}, 1500);
+
+// Phase 3: worker-2 완료
+setTimeout(() => {
+  tui.updateWorker("worker-1", {
+    progress: 0.78, tokens: "2.1k", confidence: "high",
+    snapshot: "applying fix to tui.mjs",
+    detail: "mcp: serena/activate_project (completed)\nmcp: serena/read_file (completed)\nmcp: serena/find_symbol (completed)\nmcp: serena/replace_symbol_body started\napplying fix to tui.mjs",
+    handoff: { files_changed: ["hub/team/tui.mjs"] },
+  });
+  tui.updateWorker("worker-2", {
+    status: "completed", progress: 1, tokens: "1.5k", confidence: "high",
+    handoff: { status: "ok", verdict: "documentation updated", confidence: "high", files_changed: ["README.md"] },
+  });
+}, 3000);
+
+// Phase 4: 전부 완료
+setTimeout(() => {
+  tui.updateWorker("worker-1", {
+    status: "completed", progress: 1, tokens: "3.4k", confidence: "high",
+    handoff: { status: "ok", verdict: "fix applied and verified", confidence: "high", files_changed: ["hub/team/tui.mjs", "tests/unit/tui.test.mjs"] },
+  });
+  tui.updatePipeline({ phase: "verify" });
+}, 4500);
+
+// 종료
+setTimeout(() => { tui.close(); process.exit(0); }, 6000);

package/scripts/headless-guard.mjs

@@ -29,6 +29,7 @@ import { execFileSync } from "node:child_process";
 import { tmpdir } from "node:os";
 import { join } from "node:path";
 import { nudge, deny } from "./lib/hook-utils.mjs";
+import { probePsmuxSupport } from "./lib/psmux-info.mjs";
 
 const CACHE_FILE = join(tmpdir(), "tfx-psmux-check.json");
 const CACHE_TTL_MS = 5 * 60 * 1000; // 5분
@@ -70,16 +71,12 @@ function isPsmuxInstalled() {
     }
   } catch { /* cache miss */ }
 
-  // psmux -V 실행
-  let ok = false;
-  try {
-    execFileSync("psmux", ["-V"], { timeout: 2000, stdio: "ignore" });
-    ok = true;
-  } catch { /* not installed */ }
+  const probe = probePsmuxSupport({ execFileSyncFn: execFileSync });
+  const ok = probe.ok;
 
   // 캐시 저장
   try {
-    writeFileSync(CACHE_FILE, JSON.stringify({ ts: Date.now(), ok }));
+    writeFileSync(CACHE_FILE, JSON.stringify({ ts: Date.now(), ok, version: probe.version, missingCommands: probe.missingCommands }));
   } catch { /* ignore */ }
 
   return ok;

package/scripts/hub-ensure.mjs

@@ -1,120 +1,120 @@
-#!/usr/bin/env node
-// SessionStart 훅에서 호출되는 Hub 보장 스크립트.
-// - /status 기반 헬스체크
-// - 비정상 시 Hub를 detached로 기동
-
-import { existsSync, readFileSync } from "fs";
-import { join, dirname } from "path";
-import { homedir } from "os";
-import { spawn } from "child_process";
-import { fileURLToPath } from "url";
-
-const LOOPBACK_HOSTS = new Set(["127.0.0.1", "localhost", "::1"]);
-const PLUGIN_ROOT = dirname(dirname(fileURLToPath(import.meta.url)));
-const HUB_PID_FILE = join(homedir(), ".claude", "cache", "tfx-hub", "hub.pid");
-
-function formatHostForUrl(host) {
-  return host.includes(":") ? `[${host}]` : host;
-}
-
-function buildHubBaseUrl(host, port) {
-  return `http://${formatHostForUrl(host)}:${port}`;
-}
-
-function resolveHubTarget() {
-  const envPortRaw = Number(process.env.TFX_HUB_PORT || "");
-  const envPort = Number.isFinite(envPortRaw) && envPortRaw > 0 ? envPortRaw : null;
-  const target = {
-    host: "127.0.0.1",
-    port: envPort || 27888,
-  };
-
-  if (existsSync(HUB_PID_FILE)) {
-    try {
-      const info = JSON.parse(readFileSync(HUB_PID_FILE, "utf8"));
-      if (!envPort) {
-        const pidPort = Number(info?.port);
-        if (Number.isFinite(pidPort) && pidPort > 0) target.port = pidPort;
-      }
-      if (typeof info?.host === "string") {
-        const host = info.host.trim();
-        if (LOOPBACK_HOSTS.has(host)) target.host = host;
-      }
-    } catch {
-      // ignore parse errors and use env/default
-    }
-  }
-
-  return target;
-}
-
-async function isHubHealthy(host, port) {
-  try {
-    const res = await fetch(`${buildHubBaseUrl(host, port)}/status`, {
-      signal: AbortSignal.timeout(1000),
-    });
-    if (!res.ok) return false;
-    const data = await res.json();
-    return data?.hub?.state === "healthy";
-  } catch {
-    return false;
-  }
-}
-
-function startHubDetached(port) {
-  const serverPath = join(PLUGIN_ROOT, "hub", "server.mjs");
-  if (!existsSync(serverPath)) return false;
-
-  try {
-    const env = { ...process.env, TFX_HUB_PORT: String(port) };
-    if (process.platform === "win32") {
-      // Windows: cmd.exe /c start /b → 완전 독립 프로세스 트리 생성
-      // hook timeout 시 프로세스 트리 킬에서 살아남음
-      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();
-    }
-    return true;
-  } catch {
-    return false;
-  }
-}
-
-/** Hub 기동 후 ready 상태까지 대기 (최대 maxWaitMs) */
-async function waitForHubReady(host, port, maxWaitMs = 5000) {
-  const interval = 250;
-  const deadline = Date.now() + maxWaitMs;
-  while (Date.now() < deadline) {
-    if (await isHubHealthy(host, port)) return true;
-    await new Promise((r) => setTimeout(r, interval));
-  }
-  return false;
-}
-
-const { host, port } = resolveHubTarget();
-if (!(await isHubHealthy(host, port))) {
-  const started = startHubDetached(port);
-  if (started) {
-    const ready = await waitForHubReady(host, port, 3000);
-    if (ready) {
-      process.stdout.write("hub: ok");
-    } else {
-      // fire-and-forget: hub이 아직 기동 중일 수 있음 — 에러가 아닌 경고
-      process.stdout.write("hub: starting");
-    }
-  } else {
-    process.stderr.write("[hub-ensure] hub 시작 실패");
-  }
-} else {
-  process.stdout.write("hub: ok");
-}
+#!/usr/bin/env node
+// SessionStart 훅에서 호출되는 Hub 보장 스크립트.
+// - /status 기반 헬스체크
+// - 비정상 시 Hub를 detached로 기동
+
+import { existsSync, readFileSync } from "fs";
+import { join, dirname } from "path";
+import { homedir } from "os";
+import { spawn } from "child_process";
+import { fileURLToPath } from "url";
+
+const LOOPBACK_HOSTS = new Set(["127.0.0.1", "localhost", "::1"]);
+const PLUGIN_ROOT = dirname(dirname(fileURLToPath(import.meta.url)));
+const HUB_PID_FILE = join(homedir(), ".claude", "cache", "tfx-hub", "hub.pid");
+
+function formatHostForUrl(host) {
+  return host.includes(":") ? `[${host}]` : host;
+}
+
+function buildHubBaseUrl(host, port) {
+  return `http://${formatHostForUrl(host)}:${port}`;
+}
+
+function resolveHubTarget() {
+  const envPortRaw = Number(process.env.TFX_HUB_PORT || "");
+  const envPort = Number.isFinite(envPortRaw) && envPortRaw > 0 ? envPortRaw : null;
+  const target = {
+    host: "127.0.0.1",
+    port: envPort || 27888,
+  };
+
+  if (existsSync(HUB_PID_FILE)) {
+    try {
+      const info = JSON.parse(readFileSync(HUB_PID_FILE, "utf8"));
+      if (!envPort) {
+        const pidPort = Number(info?.port);
+        if (Number.isFinite(pidPort) && pidPort > 0) target.port = pidPort;
+      }
+      if (typeof info?.host === "string") {
+        const host = info.host.trim();
+        if (LOOPBACK_HOSTS.has(host)) target.host = host;
+      }
+    } catch {
+      // ignore parse errors and use env/default
+    }
+  }
+
+  return target;
+}
+
+async function isHubHealthy(host, port) {
+  try {
+    const res = await fetch(`${buildHubBaseUrl(host, port)}/status`, {
+      signal: AbortSignal.timeout(1000),
+    });
+    if (!res.ok) return false;
+    const data = await res.json();
+    return data?.hub?.state === "healthy";
+  } catch {
+    return false;
+  }
+}
+
+function startHubDetached(port) {
+  const serverPath = join(PLUGIN_ROOT, "hub", "server.mjs");
+  if (!existsSync(serverPath)) return false;
+
+  try {
+    const env = { ...process.env, TFX_HUB_PORT: String(port) };
+    if (process.platform === "win32") {
+      // Windows: cmd.exe /c start /b → 완전 독립 프로세스 트리 생성
+      // hook timeout 시 프로세스 트리 킬에서 살아남음
+      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();
+    }
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+/** Hub 기동 후 ready 상태까지 대기 (최대 maxWaitMs) */
+async function waitForHubReady(host, port, maxWaitMs = 5000) {
+  const interval = 250;
+  const deadline = Date.now() + maxWaitMs;
+  while (Date.now() < deadline) {
+    if (await isHubHealthy(host, port)) return true;
+    await new Promise((r) => setTimeout(r, interval));
+  }
+  return false;
+}
+
+const { host, port } = resolveHubTarget();
+if (!(await isHubHealthy(host, port))) {
+  const started = startHubDetached(port);
+  if (started) {
+    const ready = await waitForHubReady(host, port, 3000);
+    if (ready) {
+      process.stdout.write("hub: ok");
+    } else {
+      // fire-and-forget: hub이 아직 기동 중일 수 있음 — 에러가 아닌 경고
+      process.stdout.write("hub: starting");
+    }
+  } else {
+    process.stderr.write("[hub-ensure] hub 시작 실패");
+  }
+} else {
+  process.stdout.write("hub: ok");
+}

package/scripts/lib/psmux-info.mjs

@@ -0,0 +1,119 @@
+import { execFileSync } from "node:child_process";
+
+export const PSMUX_RECOMMENDED_VERSION = "3.3.1";
+export const PSMUX_REQUIRED_COMMANDS = [
+  "new-session",
+  "attach-session",
+  "kill-session",
+  "capture-pane",
+];
+
+export const PSMUX_OPTIONAL_COMMANDS = [
+  "detach-client",
+];
+
+export const PSMUX_INSTALL_COMMANDS = [
+  "winget install marlocarlo.psmux",
+  "scoop install psmux",
+  "choco install psmux",
+  "cargo install psmux",
+];
+
+export const PSMUX_UPDATE_COMMANDS = [
+  "winget upgrade marlocarlo.psmux",
+  "scoop update psmux",
+  "choco upgrade psmux",
+  "cargo install psmux --force",
+];
+
+export function formatPsmuxCommandList(commands = PSMUX_INSTALL_COMMANDS, indent = "") {
+  return commands.map((command) => `${indent}${command}`).join("\n");
+}
+
+export function formatPsmuxInstallGuidance(indent = "") {
+  return formatPsmuxCommandList(PSMUX_INSTALL_COMMANDS, indent);
+}
+
+export function formatPsmuxUpdateGuidance(indent = "") {
+  return formatPsmuxCommandList(PSMUX_UPDATE_COMMANDS, indent);
+}
+
+export function parsePsmuxVersion(output = "") {
+  const match = String(output).match(/psmux\s+v?(\d+\.\d+\.\d+)/i);
+  return match?.[1] || null;
+}
+
+export function compareSemver(a, b) {
+  const left = String(a || "").split(".").map((part) => Number.parseInt(part, 10) || 0);
+  const right = String(b || "").split(".").map((part) => Number.parseInt(part, 10) || 0);
+  for (let index = 0; index < 3; index += 1) {
+    if (left[index] > right[index]) return 1;
+    if (left[index] < right[index]) return -1;
+  }
+  return 0;
+}
+
+export function isRecommendedPsmuxVersion(version) {
+  if (!version) return false;
+  return compareSemver(version, PSMUX_RECOMMENDED_VERSION) >= 0;
+}
+
+export function probePsmuxSupport(options = {}) {
+  const execFileSyncFn = options.execFileSyncFn || execFileSync;
+  const bin = options.bin || "psmux";
+
+  try {
+    const versionOutput = execFileSyncFn(bin, ["-V"], {
+      encoding: "utf8",
+      timeout: 2000,
+      stdio: ["ignore", "pipe", "pipe"],
+      windowsHide: true,
+    });
+    const version = parsePsmuxVersion(versionOutput);
+
+    let helpOutput = "";
+    try {
+      helpOutput = execFileSyncFn(bin, ["--help"], {
+        encoding: "utf8",
+        timeout: 2000,
+        stdio: ["ignore", "pipe", "pipe"],
+        windowsHide: true,
+      });
+    } catch {
+      helpOutput = "";
+    }
+
+    const missingCommands = PSMUX_REQUIRED_COMMANDS.filter(
+      (command) => !helpOutput || !helpOutput.includes(command),
+    );
+    const missingOptionalCommands = PSMUX_OPTIONAL_COMMANDS.filter(
+      (command) => !helpOutput || !helpOutput.includes(command),
+    );
+
+    return {
+      ok: missingCommands.length === 0,
+      installed: true,
+      version,
+      recommendedVersion: PSMUX_RECOMMENDED_VERSION,
+      recommended: isRecommendedPsmuxVersion(version),
+      missingCommands,
+      missingOptionalCommands,
+      hasHelp: helpOutput.length > 0,
+      installHint: formatPsmuxInstallGuidance("  "),
+      updateHint: formatPsmuxUpdateGuidance("  "),
+    };
+  } catch {
+    return {
+      ok: false,
+      installed: false,
+      version: null,
+      recommendedVersion: PSMUX_RECOMMENDED_VERSION,
+      recommended: false,
+      missingCommands: [...PSMUX_REQUIRED_COMMANDS],
+      missingOptionalCommands: [...PSMUX_OPTIONAL_COMMANDS],
+      hasHelp: false,
+      installHint: formatPsmuxInstallGuidance("  "),
+      updateHint: formatPsmuxUpdateGuidance("  "),
+    };
+  }
+}

package/scripts/lib/remote-spawn-transfer.mjs

@@ -193,4 +193,4 @@ export function buildRemoteTransferPlan(options = {}) {
     stagedHandoffPath,
     transfers,
   };
-}
+}