triflux 8.4.1 → 8.5.1

package/README.ko.md

@@ -61,6 +61,10 @@
 
 ## Tri-CLI 합의 엔진
 
+<p align="center">
+  <img src="docs/assets/consensus-flow.svg" alt="Tri-CLI Consensus 플로우" width="680">
+</p>
+
 triflux의 핵심 혁신입니다. 단일 모델을 맹신하는 대신, 모든 Deep 스킬은 다음 과정을 거칩니다:
 
 ```
@@ -175,6 +179,10 @@ Phase 3: Resolution (합의율 < 70%일 경우)
 
 모든 도메인에서 두 가지 모드를 제공합니다:
 
+<p align="center">
+  <img src="docs/assets/deep-vs-light.svg" alt="Deep vs Light 비교" width="680">
+</p>
+
 | 항목 | Light | Deep |
 |------|-------|------|
 | **CLI** | 단일 (주로 Codex) | 3자 (Claude + Codex + Gemini) |
@@ -188,6 +196,13 @@ Phase 3: Resolution (합의율 < 70%일 경우)
 
 ## 아키텍처
 
+<p align="center">
+  <img src="docs/assets/architecture.svg" alt="triflux 아키텍처" width="680">
+</p>
+
+<details>
+<summary>인터랙티브 다이어그램 (GitHub 전용)</summary>
+
 ```mermaid
 graph TD
     User([사용자 / Claude Code]) <-->|Skills & Slash Commands| TFX[tfx Skills Layer]
@@ -217,6 +232,8 @@ graph TD
     HUB -.->|MCP Bridge| External[외부 MCP 클라이언트]
 ```
 
+</details>
+
 ---
 
 ## 빠른 시작

package/README.md

@@ -61,6 +61,10 @@
 
 ## Tri-CLI Consensus
 
+<p align="center">
+  <img src="docs/assets/consensus-flow.svg" alt="Tri-CLI Consensus Flow" width="680">
+</p>
+
 The core innovation of triflux. Instead of trusting a single model, every Deep skill runs:
 
 ```
@@ -175,6 +179,10 @@ Phase 3: Resolution (if consensus < 70%)
 
 Every domain offers both modes:
 
+<p align="center">
+  <img src="docs/assets/deep-vs-light.svg" alt="Deep vs Light comparison" width="680">
+</p>
+
 | Dimension | Light | Deep |
 |-----------|-------|------|
 | **CLIs** | Single (usually Codex) | 3-party (Claude + Codex + Gemini) |
@@ -188,6 +196,13 @@ Every domain offers both modes:
 
 ## Architecture
 
+<p align="center">
+  <img src="docs/assets/architecture.svg" alt="triflux architecture" width="680">
+</p>
+
+<details>
+<summary>Interactive diagram (GitHub only)</summary>
+
 ```mermaid
 graph TD
     User([User / Claude Code]) <-->|Skills & Slash Commands| TFX[tfx Skills Layer]
@@ -217,6 +232,8 @@ graph TD
     HUB -.->|MCP Bridge| External[External MCP Clients]
 ```
 
+</details>
+
 ---
 
 ## Quick Start

package/bin/triflux.mjs

@@ -1403,7 +1403,7 @@ async function cmdDoctor(options = {}) {
         // --fix 없이는 개수만 보고
         const { execSync: execSyncDoctor } = await import("node:child_process");
         const countStr = execSyncDoctor(
-          `powershell -NoProfile -Command "(Get-Process node -ErrorAction SilentlyContinue).Count"`,
+          `powershell -NoProfile -WindowStyle Hidden -Command "(Get-Process node -ErrorAction SilentlyContinue).Count"`,
           { encoding: "utf8", timeout: 5000 },
         ).trim();
         const count = Number.parseInt(countStr, 10) || 0;
@@ -1486,7 +1486,7 @@ async function cmdDoctor(options = {}) {
                 // Claude Code 프로세스에서 세션 ID 검색
                 if (process.platform === "win32") {
                   const psOut = execSync(
-                    `powershell -NoProfile -Command "$ErrorActionPreference='SilentlyContinue'; Get-CimInstance Win32_Process | Where-Object { $_.CommandLine -match '${safeToken}' } | Select-Object ProcessId | ConvertTo-Json -Compress"`,
+                    `powershell -NoProfile -WindowStyle Hidden -Command "$ErrorActionPreference='SilentlyContinue'; Get-CimInstance Win32_Process | Where-Object { $_.CommandLine -match '${safeToken}' } | Select-Object ProcessId | ConvertTo-Json -Compress"`,
                     { encoding: "utf8", timeout: 8000, stdio: ["ignore", "pipe", "ignore"], windowsHide: true },
                   ).trim();
                   if (psOut && psOut !== "null") {
@@ -1497,7 +1497,7 @@ async function cmdDoctor(options = {}) {
                 } else {
                   const psOut = execSync(
                     `ps -ax -o pid=,command= | grep -i '${safeToken}' | grep -v grep`,
-                    { encoding: "utf8", timeout: 5000, stdio: ["ignore", "pipe", "ignore"] },
+                    { encoding: "utf8", timeout: 5000, stdio: ["ignore", "pipe", "ignore"], windowsHide: true },
                   ).trim();
                   hasActiveMember = psOut.length > 0;
                 }

package/hub/lib/process-utils.mjs

@@ -155,8 +155,8 @@ export function cleanupOrphanNodeProcesses() {
 
   try {
     const treeOutput = execSync(
-      `powershell -NoProfile -ExecutionPolicy Bypass -File "${TREE_SCRIPT_PATH}" -StartPid ${myPid}`,
-      { encoding: "utf8", timeout: 8000, stdio: ["pipe", "pipe", "pipe"] },
+      `powershell -NoProfile -WindowStyle Hidden -ExecutionPolicy Bypass -File "${TREE_SCRIPT_PATH}" -StartPid ${myPid}`,
+      { encoding: "utf8", timeout: 8000, stdio: ["pipe", "pipe", "pipe"], windowsHide: true },
     );
     for (const line of treeOutput.split(/\r?\n/)) {
       const pid = Number.parseInt(line.trim(), 10);
@@ -168,8 +168,8 @@ export function cleanupOrphanNodeProcesses() {
   const procMap = new Map();
   try {
     const output = execSync(
-      `powershell -NoProfile -ExecutionPolicy Bypass -File "${SCAN_SCRIPT_PATH}"`,
-      { encoding: "utf8", timeout: 15000, stdio: ["pipe", "pipe", "pipe"] },
+      `powershell -NoProfile -WindowStyle Hidden -ExecutionPolicy Bypass -File "${SCAN_SCRIPT_PATH}"`,
+      { encoding: "utf8", timeout: 15000, stdio: ["pipe", "pipe", "pipe"], windowsHide: true },
     );
 
     for (const line of output.split(/\r?\n/)) {
@@ -203,8 +203,8 @@ export function cleanupOrphanNodeProcesses() {
   let remaining = 0;
   try {
     const countOutput = execSync(
-      `powershell -NoProfile -Command "(Get-Process node -ErrorAction SilentlyContinue).Count"`,
-      { encoding: "utf8", timeout: 5000, stdio: ["pipe", "pipe", "pipe"] },
+      `powershell -NoProfile -WindowStyle Hidden -Command "(Get-Process node -ErrorAction SilentlyContinue).Count"`,
+      { encoding: "utf8", timeout: 5000, stdio: ["pipe", "pipe", "pipe"], windowsHide: true },
     );
     remaining = Number.parseInt(countOutput.trim(), 10) || 0;
   } catch {}

package/hub/team/psmux.mjs

@@ -514,8 +514,8 @@ function killOrphanPipeHelpers(sessionName) {
   const safeSession = sanitizePathPart(sessionName);
   try {
     const output = childProcess.execSync(
-      `powershell -NoProfile -Command "$ErrorActionPreference='SilentlyContinue'; Get-CimInstance Win32_Process | Where-Object { $_.CommandLine -match 'pipe-pane-capture' -and $_.CommandLine -match '${safeSession}' } | Select-Object -ExpandProperty ProcessId"`,
-      { encoding: "utf8", timeout: 8000, stdio: ["pipe", "pipe", "pipe"] },
+      `powershell -NoProfile -WindowStyle Hidden -Command "$ErrorActionPreference='SilentlyContinue'; Get-CimInstance Win32_Process | Where-Object { $_.CommandLine -match 'pipe-pane-capture' -and $_.CommandLine -match '${safeSession}' } | Select-Object -ExpandProperty ProcessId"`,
+      { encoding: "utf8", timeout: 8000, stdio: ["pipe", "pipe", "pipe"], windowsHide: true },
     );
     const pids = output.split(/\r?\n/).map((l) => Number.parseInt(l.trim(), 10)).filter((p) => Number.isFinite(p) && p > 0);
     for (const pid of pids) {
@@ -549,8 +549,8 @@ function killOrphanMcpProcesses(sessionName) {
   try {
     // 세션 결과 디렉토리 패턴으로 MCP 서버 프로세스 식별
     const output = childProcess.execSync(
-      `powershell -NoProfile -Command "$ErrorActionPreference='SilentlyContinue'; Get-CimInstance Win32_Process | Where-Object { $_.Name -eq 'node.exe' -and $_.CommandLine -match '${safeSession}' } | Select-Object -ExpandProperty ProcessId"`,
-      { encoding: "utf8", timeout: 8000, stdio: ["pipe", "pipe", "pipe"] },
+      `powershell -NoProfile -WindowStyle Hidden -Command "$ErrorActionPreference='SilentlyContinue'; Get-CimInstance Win32_Process | Where-Object { $_.Name -eq 'node.exe' -and $_.CommandLine -match '${safeSession}' } | Select-Object -ExpandProperty ProcessId"`,
+      { encoding: "utf8", timeout: 8000, stdio: ["pipe", "pipe", "pipe"], windowsHide: true },
     );
     const pids = output.split(/\r?\n/).map((l) => Number.parseInt(l.trim(), 10)).filter((p) => Number.isFinite(p) && p > 0 && p !== hubPid);
     for (const pid of pids) {

package/hub/team/tui-viewer.mjs

@@ -388,9 +388,12 @@ function ingest() {
 }
 
 // ── tui.updateWorker 래퍼 — raw internal data 누출 방지 ──
-function pushToTui(paneName, cli, role, update) {
+function pushToTui(paneName, cli, paneTitle, update) {
   // _leadAction은 tui에 노출하지 않음 (내부용)
   const { _leadAction: _ignored, ...safeUpdate } = update;
+  // pane title에서 실제 역할만 추출: "⚪ codex (executor)" → "executor"
+  const roleMatch = paneTitle.match(/\(([^)]+)\)$/);
+  const role = roleMatch ? roleMatch[1] : "";
   tui.updateWorker(paneName, { cli, role, ...safeUpdate });
 }
 

package/hub/team/tui.mjs

@@ -72,6 +72,13 @@ function heartbeat(status, shimmerIntensity = 0) {
     : SPINNER_BASE_COLOR;
   return `\x1b[38;2;${c.r};${c.g};${c.b}m${SPINNER_FRAMES[idx]}${RESET}`;
 }
+
+function currentShimmer() {
+  const elapsed = Date.now() - spinnerStart;
+  const t = (elapsed % SPINNER_CYCLE_MS) / SPINNER_CYCLE_MS;
+  return 0.5 * (1 + Math.sin(t * Math.PI * 2));
+}
+
 const GRID_GAP = 2;
 const DEFAULT_DETAIL_LINES = 10;
 // Tier1 상단 고정 행 수
@@ -215,6 +222,21 @@ function fadeBorderColor(currentStatus, prevStatus, changedAt) {
   return `\x1b[38;2;${c.r};${c.g};${c.b}m`;
 }
 
+function dedupeRole(role, name, cli) {
+  if (!role) return "";
+  let r = role;
+  const esc = (s) => s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+  r = r.replace(new RegExp(esc(cli), "gi"), "").trim();
+  r = r.replace(new RegExp(esc(name), "gi"), "").trim();
+  // CLI indicator emojis 제거
+  r = r.replace(/[⚪⚫🔴🟠🟡🟢🔵🟣🟤⭕🔘]/g, "").trim();
+  // 빈 괄호 제거 + 중첩 괄호 정리
+  r = r.replace(/\(\s*\)/g, "").trim();
+  r = r.replace(/^\(([^()]+)\)$/, "$1").trim();
+  r = r.replace(/^\s*[•·\-]\s*/, "").trim();
+  return r;
+}
+
 // ── 텍스트 래핑 ──────────────────────────────────────────────────────────
 function wrapLine(text, width) {
   const limit = Math.max(8, width);
@@ -310,7 +332,7 @@ function buildTier1(names, workers, pipeline, elapsed, width, version) {
   const phase = pipeline.phase || "exec";
   const row1 = truncate(
     `${color("▲", FG.triflux)} v${version} ${dim("│")} ${color(phase, phaseColor(phase))} ${dim("│")} ${elapsed}s ${dim("│")} ` +
-    `${color(`✓${ok}`, MOCHA.ok)} ${color(`◑${partial}`, MOCHA.partial)} ${color(`✗${failed}`, MOCHA.fail)} ${dim(`▶${running}`)}  ${color("Tab/j/k:nav • f:follow • r:raw • 1-9:jump", MOCHA.subtext)}`,
+    `${color(`✓${ok}`, MOCHA.ok)} ${color(`◑${partial}`, MOCHA.partial)} ${color(`✗${failed}`, MOCHA.fail)} ${dim(`▶${running}`)}  ${color("Tab:focus • j/k/↑↓:nav • f:follow • r:raw • l:tab • 1-9:jump", MOCHA.subtext)}`,
     width,
   );
   return [row1];
@@ -357,9 +379,10 @@ function buildWorkerRail(name, st, opts = {}) {
 
   // Tier2 행 1: 이름 + CLI + role
   const selMark = selected ? (focused ? color("▶", MOCHA.blue) : color(">", FG.triflux)) : " ";
-  const hb = heartbeat(status);
+  const hb = heartbeat(status, status === "running" ? currentShimmer() : 0);
+  const displayRole = dedupeRole(role, name, cli);
   const title = truncate(
-    `${selMark} ${hb} ${color(name, FG.triflux)} ${color("•", MOCHA.overlay)} ${color(cli, cliColor(cli))}${role ? ` ${color(`(${role})`, MOCHA.overlay)}` : ""}`,
+    `${selMark} ${hb} ${color(name, FG.triflux)} ${color("•", MOCHA.overlay)} ${color(cli, cliColor(cli))}${displayRole ? ` ${color(`(${displayRole})`, MOCHA.overlay)}` : ""}`,
     innerWidth,
   );
 
@@ -442,9 +465,10 @@ function buildFocusPane(name, st, opts = {}) {
   const status = runtimeStatus(st);
 
   // Tab bar: 활성 탭은 MOCHA.blue + bold, 비활성은 MOCHA.overlay
-  const tabLog = `${MOCHA.blue}${bold("[Log]")}`;
-  const tabDetail = color("[Detail]", MOCHA.overlay);
-  const tabFiles = color(`[Files ${files.length}]`, MOCHA.overlay);
+  const activeTab = opts.activeTab || "log";
+  const tabLog = activeTab === "log" ? `${MOCHA.blue}${bold("[Log]")}` : color("[Log]", MOCHA.overlay);
+  const tabDetail = activeTab === "detail" ? `${MOCHA.blue}${bold("[Detail]")}` : color("[Detail]", MOCHA.overlay);
+  const tabFiles = activeTab === "files" ? `${MOCHA.blue}${bold(`[Files ${files.length}]`)}` : color(`[Files ${files.length}]`, MOCHA.overlay);
   const tabBar = truncate(`${tabLog} ${tabDetail} ${tabFiles}`, innerWidth);
 
   const stickyLines = [
@@ -457,7 +481,26 @@ function buildFocusPane(name, st, opts = {}) {
 
   // 본문 스크롤 영역
   const bodyAvail = Math.max(0, height - stickyLines.length - 3); // top+bot border + scrollInfo
-  const allBodyLines = wrapTextAll(detailText(st), innerWidth, rawMode);
+
+  let allBodyLines;
+  if (activeTab === "detail") {
+    const summaryLines = [];
+    for (const key of SUMMARY_KEYS) {
+      const value = st.handoff?.[key];
+      if (Array.isArray(value) && value.length > 0) summaryLines.push(`${key}: ${value.join(", ")}`);
+      else if (value) summaryLines.push(`${key}: ${value}`);
+    }
+    allBodyLines = summaryLines.length > 0
+      ? summaryLines.flatMap((l) => wrapLine(l, innerWidth))
+      : [dim("no structured data")];
+  } else if (activeTab === "files") {
+    const filesList = sanitizeFiles(st.handoff?.files_changed || st.files_changed);
+    allBodyLines = filesList.length > 0
+      ? filesList.map((f, i) => `${i + 1}. ${f}`)
+      : [dim("no files changed")];
+  } else {
+    allBodyLines = wrapTextAll(detailText(st), innerWidth, rawMode);
+  }
 
   let startIdx;
   if (followTail) {
@@ -497,7 +540,7 @@ function buildSummaryBar(names, workers, selectedWorker, pipeline, width, versio
     return padRight(truncate(label, maxChipWidth), maxChipWidth);
   });
   const chipsLine = truncate(chips.join(color(" │ ", MOCHA.overlay)), width - 4);
-  const keysLine = truncate(color("Tab:focus • j/k:scroll • f:follow • r:raw • 1-9:jump", MOCHA.subtext), width - 4);
+  const keysLine = truncate(color("Tab:focus • j/k/↑↓:nav • f:follow • r:raw • l:tab • 1-9:jump", MOCHA.subtext), width - 4);
   const framed = box([chipsLine, keysLine], width);
   return [framed.top, ...framed.body, framed.bot];
 }
@@ -590,6 +633,7 @@ export function createLogDashboard(opts = {}) {
   let detailScrollOffset = 0;
   let followTail = false;
   let rawMode = false;
+  let focusTab = "log"; // "log" | "detail" | "files"
   let inputAttached = false;
   let rawModeEnabled = false;
 
@@ -682,6 +726,14 @@ export function createLogDashboard(opts = {}) {
     if (key === "f") { followTail = !followTail; if (followTail) detailScrollOffset = 0; render(); return; }
     // r: raw mode 토글
     if (key === "r") { rawMode = !rawMode; render(); return; }
+    // l: 탭 전환 (Log → Detail → Files)
+    if (key === "l") {
+      const tabs = ["log", "detail", "files"];
+      focusTab = tabs[(tabs.indexOf(focusTab) + 1) % tabs.length];
+      detailScrollOffset = 0;
+      render();
+      return;
+    }
     // 1-9: 워커 직접 선택
     if (/^[1-9]$/.test(key)) {
       const names = visibleWorkerNames();
@@ -747,6 +799,7 @@ export function createLogDashboard(opts = {}) {
         followTail,
         rawMode,
         focused: focus === "detail",
+        activeTab: focusTab,
       });
       return [...tier1, ...summaryBar, ...focusPane];
     }
@@ -765,7 +818,7 @@ export function createLogDashboard(opts = {}) {
     const railLines = [];
     for (const name of names) {
       const card = buildWorkerRail(name, workers.get(name), {
-        width: railWidth - 2, // box 테두리 감안
+        width: railWidth,
         selected: name === selectedWorker,
         focused: focus === "rail" && name === selectedWorker,
         rawMode,
@@ -787,6 +840,7 @@ export function createLogDashboard(opts = {}) {
         followTail,
         rawMode,
         focused: focus === "detail",
+        activeTab: focusTab,
       });
     }
     while (focusLines.length < bodyHeight) focusLines.push(padRight("", focusWidth));
@@ -927,6 +981,15 @@ export function createLogDashboard(opts = {}) {
       return focus === "detail";
     },
 
+    getFocusTab() {
+      return focusTab;
+    },
+
+    setFocusTab(tab) {
+      const valid = ["log", "detail", "files"];
+      if (valid.includes(tab)) { focusTab = tab; detailScrollOffset = 0; }
+    },
+
     getLayout() {
       return layoutHint;
     },

package/hud/utils.mjs

@@ -6,9 +6,7 @@ import { dirname } from "node:path";
 import { createHash } from "node:crypto";
 import {
   PERCENT_CELL_WIDTH, TIME_CELL_INNER_WIDTH, SV_CELL_WIDTH,
-  FIVE_HOUR_MS, SEVEN_DAY_MS,
 } from "./constants.mjs";
-import { dim } from "./colors.mjs";
 
 export async function readStdinJson() {
   if (process.stdin.isTTY) return {};
@@ -58,16 +56,23 @@ export function stripAnsi(text) {
   return String(text).replace(/\x1b\[[0-9;]*m/g, "");
 }
 
-export function padAnsiRight(text, width) {
-  const len = stripAnsi(text).length;
+function getVisibleLength(text) {
+  return stripAnsi(text).length;
+}
+
+function padAnsi(text, width, align = "right") {
+  const len = getVisibleLength(text);
   if (len >= width) return text;
-  return text + " ".repeat(width - len);
+  const padding = " ".repeat(width - len);
+  return align === "left" ? padding + text : text + padding;
+}
+
+export function padAnsiRight(text, width) {
+  return padAnsi(text, width, "right");
 }
 
 export function padAnsiLeft(text, width) {
-  const len = stripAnsi(text).length;
-  if (len >= width) return text;
-  return " ".repeat(width - len) + text;
+  return padAnsi(text, width, "left");
 }
 
 export function fitText(text, width) {
@@ -164,13 +169,29 @@ export function advanceToNextCycle(epochMs, cycleMs) {
   return epochMs + Math.ceil(elapsed / cycleMs) * cycleMs;
 }
 
+function parseResetDate(isoOrUnix) {
+  if (!isoOrUnix) return null;
+  const date = typeof isoOrUnix === "string"
+    ? new Date(isoOrUnix)
+    : new Date(isoOrUnix * 1000);
+  return Number.isNaN(date.getTime()) ? null : date;
+}
+
+function getResetTargetMs(isoOrUnix, cycleMs = 0) {
+  const date = parseResetDate(isoOrUnix);
+  if (!date) return null;
+  return advanceToNextCycle(date.getTime(), cycleMs);
+}
+
+function getRemainingResetMs(isoOrUnix, cycleMs = 0) {
+  const targetMs = getResetTargetMs(isoOrUnix, cycleMs);
+  if (targetMs == null) return null;
+  return targetMs - Date.now();
+}
+
 export function formatResetRemaining(isoOrUnix, cycleMs = 0) {
-  if (!isoOrUnix) return "";
-  const d = typeof isoOrUnix === "string" ? new Date(isoOrUnix) : new Date(isoOrUnix * 1000);
-  if (isNaN(d.getTime())) return "";
-  const targetMs = advanceToNextCycle(d.getTime(), cycleMs);
-  const diffMs = targetMs - Date.now();
-  if (diffMs <= 0) return "";
+  const diffMs = getRemainingResetMs(isoOrUnix, cycleMs);
+  if (diffMs == null || diffMs <= 0) return "";
   const totalMinutes = Math.floor(diffMs / 60000);
   const totalHours = Math.floor(totalMinutes / 60);
   const minutes = totalMinutes % 60;
@@ -178,18 +199,13 @@ export function formatResetRemaining(isoOrUnix, cycleMs = 0) {
 }
 
 export function isResetPast(isoOrUnix) {
-  if (!isoOrUnix) return false;
-  const d = typeof isoOrUnix === "string" ? new Date(isoOrUnix) : new Date(isoOrUnix * 1000);
-  return !isNaN(d.getTime()) && d.getTime() <= Date.now();
+  const date = parseResetDate(isoOrUnix);
+  return date != null && date.getTime() <= Date.now();
 }
 
 export function formatResetRemainingDayHour(isoOrUnix, cycleMs = 0) {
-  if (!isoOrUnix) return "";
-  const d = typeof isoOrUnix === "string" ? new Date(isoOrUnix) : new Date(isoOrUnix * 1000);
-  if (isNaN(d.getTime())) return "";
-  const targetMs = advanceToNextCycle(d.getTime(), cycleMs);
-  const diffMs = targetMs - Date.now();
-  if (diffMs <= 0) return "";
+  const diffMs = getRemainingResetMs(isoOrUnix, cycleMs);
+  if (diffMs == null || diffMs <= 0) return "";
   const totalMinutes = Math.floor(diffMs / 60000);
   const days = Math.floor(totalMinutes / (60 * 24));
   const hours = Math.floor((totalMinutes % (60 * 24)) / 60);

package/package.json

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