triflux 6.1.3 → 7.0.1

package/hub/team/ansi.mjs

@@ -0,0 +1,114 @@
+// hub/team/ansi.mjs — Zero-dependency ANSI escape 유틸리티
+// TUI 대시보드 렌더링을 위한 최소 헬퍼.
+
+export const ESC = "\x1b";
+
+// ── 화면 ──
+export const altScreenOn  = `${ESC}[?1049h`;
+export const altScreenOff = `${ESC}[?1049l`;
+export const clearScreen  = `${ESC}[2J`;
+export const cursorHome   = `${ESC}[H`;
+export const cursorHide   = `${ESC}[?25l`;
+export const cursorShow   = `${ESC}[?25h`;
+
+// ── 커서 이동 ──
+export function moveTo(row, col) { return `${ESC}[${row};${col}H`; }
+export function moveUp(n = 1)    { return `${ESC}[${n}A`; }
+export function moveDown(n = 1)  { return `${ESC}[${n}B`; }
+
+// ── 줄 제어 ──
+export const clearLine    = `${ESC}[2K`;
+export const clearToEnd   = `${ESC}[K`;
+
+// ── 색상 (triflux 디자인 시스템) ──
+export const RESET = `${ESC}[0m`;
+export const BOLD  = `${ESC}[1m`;
+export const DIM   = `${ESC}[2m`;
+
+export const FG = {
+  white:    `${ESC}[97m`,
+  black:    `${ESC}[30m`,
+  red:      `${ESC}[31m`,
+  green:    `${ESC}[32m`,
+  yellow:   `${ESC}[33m`,
+  blue:     `${ESC}[34m`,
+  magenta:  `${ESC}[35m`,
+  cyan:     `${ESC}[36m`,
+  gray:     `${ESC}[90m`,
+  // triflux 브랜드
+  codex:    `${ESC}[97m`,              // bright white
+  gemini:   `${ESC}[38;5;39m`,         // blue
+  claude:   `${ESC}[38;2;232;112;64m`, // orange
+  triflux:  `${ESC}[38;5;214m`,        // amber
+  accent:   `${ESC}[38;5;75m`,         // light blue (Catppuccin blue)
+  muted:    `${ESC}[38;5;245m`,        // gray
+};
+
+export const BG = {
+  black:   `${ESC}[40m`,
+  red:     `${ESC}[41m`,
+  green:   `${ESC}[42m`,
+  yellow:  `${ESC}[43m`,
+  blue:    `${ESC}[44m`,
+  header:  `${ESC}[48;5;236m`,  // dark gray
+};
+
+// ── 색상 헬퍼 ──
+export function color(text, fg, bg) {
+  const prefix = (fg || "") + (bg || "");
+  return prefix ? `${prefix}${text}${RESET}` : text;
+}
+
+export function bold(text)  { return `${BOLD}${text}${RESET}`; }
+export function dim(text)   { return `${DIM}${text}${RESET}`; }
+
+// ── 박스 그리기 (유니코드 테두리) ──
+const BOX = { tl: "┌", tr: "┐", bl: "└", br: "┘", h: "─", v: "│", ml: "├", mr: "┤" };
+
+export function box(lines, width) {
+  const top = `${BOX.tl}${BOX.h.repeat(width - 2)}${BOX.tr}`;
+  const bot = `${BOX.bl}${BOX.h.repeat(width - 2)}${BOX.br}`;
+  const mid = `${BOX.ml}${BOX.h.repeat(width - 2)}${BOX.mr}`;
+  const body = lines.map((l) => `${BOX.v} ${padRight(l, width - 4)} ${BOX.v}`);
+  return { top, body, bot, mid };
+}
+
+// ── 텍스트 유틸 ──
+export function padRight(str, len) {
+  // ANSI 코드 제외한 실제 표시 길이 기준 패딩
+  const visible = stripAnsi(str);
+  const pad = Math.max(0, len - visible.length);
+  return str + " ".repeat(pad);
+}
+
+export function truncate(str, maxLen) {
+  const visible = stripAnsi(str);
+  if (visible.length <= maxLen) return str;
+  // 간단한 잘라내기 (ANSI 코드 포함 시 근사치)
+  return str.slice(0, maxLen - 1) + "…";
+}
+
+export function stripAnsi(str) {
+  return str.replace(/\x1b\[[0-9;]*[a-zA-Z]/g, "");
+}
+
+// ── 진행률 바 ──
+export function progressBar(ratio, width = 20) {
+  const filled = Math.round(ratio * width);
+  const empty = width - filled;
+  return `${FG.accent}${"█".repeat(filled)}${FG.muted}${"░".repeat(empty)}${RESET}`;
+}
+
+// ── 상태 아이콘 ──
+export const STATUS_ICON = {
+  running:   `${FG.blue}⏳${RESET}`,
+  completed: `${FG.green}✓${RESET}`,
+  failed:    `${FG.red}✗${RESET}`,
+  pending:   `${FG.gray}⏸${RESET}`,
+};
+
+export const CLI_ICON = {
+  codex:  `${FG.codex}⚪${RESET}`,
+  gemini: `${FG.gemini}🔵${RESET}`,
+  claude: `${FG.claude}🟠${RESET}`,
+};

package/hub/team/cli/commands/start/parse-args.mjs

@@ -11,6 +11,7 @@ export function parseTeamArgs(args = []) {
   let progressive = true;
   let timeoutSec = 300;
   let verbose = false;
+  let dashboard = false;
   let mcpProfile = "";
 
   for (let index = 0; index < args.length; index += 1) {
@@ -35,6 +36,8 @@ export function parseTeamArgs(args = []) {
       autoAttach = false;
     } else if (current === "--verbose") {
       verbose = true;
+    } else if (current === "--dashboard") {
+      dashboard = true;
     } else if (current === "--no-progressive") {
       progressive = false;
     } else if (current === "--timeout" && args[index + 1]) {
@@ -57,6 +60,7 @@ export function parseTeamArgs(args = []) {
     progressive,
     timeoutSec,
     verbose,
+    dashboard,
     mcpProfile,
   };
 }

package/hub/team/cli/commands/start/start-headless.mjs

@@ -1,38 +1,61 @@
 import { BOLD, DIM, GREEN, RESET, AMBER } from "../../../shared.mjs";
 import { runHeadlessInteractive, resolveCliType } from "../../../headless.mjs";
+import { createTui } from "../../../tui.mjs";
 import { ok, warn } from "../../render.mjs";
 import { buildTasks } from "../../services/task-model.mjs";
 import { clearTeamState } from "../../services/state-store.mjs";
 
-export async function startHeadlessTeam({ sessionId, task, lead, agents, subtasks, layout, assigns, autoAttach, progressive, timeoutSec, verbose, mcpProfile }) {
+export async function startHeadlessTeam({ sessionId, task, lead, agents, subtasks, layout, assigns, autoAttach, progressive, timeoutSec, verbose, dashboard, mcpProfile }) {
   // --assign이 있으면 그것을 사용, 없으면 agents+subtasks 조합
   const assignments = assigns && assigns.length > 0
     ? assigns.map((a, i) => ({ cli: resolveCliType(a.cli), prompt: a.prompt, role: a.role || `worker-${i + 1}`, mcp: mcpProfile }))
     : subtasks.map((subtask, i) => ({ cli: resolveCliType(agents[i] || agents[0]), prompt: subtask, role: `worker-${i + 1}`, mcp: mcpProfile }));
 
+  const startedAt = Date.now();
   ok(`headless ${assignments.length}워커 시작`);
 
+  // TUI 대시보드 (--dashboard 플래그)
+  const tui = dashboard ? createTui({ refreshMs: 1000 }) : null;
+
   const handle = await runHeadlessInteractive(sessionId, assignments, {
     timeoutSec: timeoutSec || 300,
     layout,
     autoAttach: !!autoAttach,
     progressive: progressive !== false,
-    progressIntervalSec: verbose ? 10 : 0,
-    onProgress: verbose ? function onProgress(event) {
-      if (event.type === "session_created") {
-        console.log(`  ${DIM}세션: ${event.sessionName}${RESET}`);
-      } else if (event.type === "worker_added") {
-        console.log(`  ${DIM}[+] ${event.paneTitle}${RESET}`);
-      } else if (event.type === "dispatched") {
-        console.log(`  ${DIM}[${event.paneName}] ${event.cli} dispatch${RESET}`);
-      } else if (event.type === "progress") {
-        const last = (event.snapshot || "").split("\n").filter(l => l.trim()).pop() || "";
-        if (last) console.log(`  ${DIM}[${event.paneName}] ${last.slice(0, 60)}${RESET}`);
-      } else if (event.type === "completed") {
-        const icon = event.matched && event.exitCode === 0 ? `${GREEN}✓${RESET}` : `${AMBER}✗${RESET}`;
-        console.log(`  ${icon} [${event.paneName}] ${event.cli} exit=${event.exitCode}${event.sessionDead ? " (dead)" : ""}`);
+    progressIntervalSec: (verbose || dashboard) ? 10 : 0,
+    onProgress: function onProgress(event) {
+      // TUI 대시보드 업데이트
+      if (tui) {
+        if (event.type === "dispatched") {
+          tui.updateWorker(event.paneName, { cli: event.cli, status: "running" });
+        } else if (event.type === "progress") {
+          const snap = (event.snapshot || "").split("\n").filter(l => l.trim()).pop() || "";
+          tui.updateWorker(event.paneName, { snapshot: snap });
+        } else if (event.type === "completed") {
+          tui.updateWorker(event.paneName, {
+            status: event.matched && event.exitCode === 0 ? "completed" : "failed",
+            elapsed: Math.round((Date.now() - (tui._start || Date.now())) / 1000),
+          });
+        }
+      }
+
+      // verbose 텍스트 출력 (TUI 비활성 시)
+      if (verbose && !tui) {
+        if (event.type === "session_created") {
+          console.log(`  ${DIM}세션: ${event.sessionName}${RESET}`);
+        } else if (event.type === "worker_added") {
+          console.log(`  ${DIM}[+] ${event.paneTitle}${RESET}`);
+        } else if (event.type === "dispatched") {
+          console.log(`  ${DIM}[${event.paneName}] ${event.cli} dispatch${RESET}`);
+        } else if (event.type === "progress") {
+          const last = (event.snapshot || "").split("\n").filter(l => l.trim()).pop() || "";
+          if (last) console.log(`  ${DIM}[${event.paneName}] ${last.slice(0, 60)}${RESET}`);
+        } else if (event.type === "completed") {
+          const icon = event.matched && event.exitCode === 0 ? `${GREEN}✓${RESET}` : `${AMBER}✗${RESET}`;
+          console.log(`  ${icon} [${event.paneName}] ${event.cli} exit=${event.exitCode}${event.sessionDead ? " (dead)" : ""}`);
+        }
       }
-    } : undefined,
+    },
   });
 
   // 최소 결과 요약
@@ -71,6 +94,21 @@ export async function startHeadlessTeam({ sessionId, task, lead, agents, subtask
     }
   }
 
+  // TUI에 handoff 최종 반영
+  if (tui) {
+    for (const r of results) {
+      if (r.handoff) {
+        tui.updateWorker(r.paneName, {
+          status: r.matched && r.exitCode === 0 ? "completed" : "failed",
+          handoff: r.handoff,
+          elapsed: Math.round((Date.now() - startedAt) / 1000),
+        });
+      }
+    }
+    tui.render();  // 최종 프레임
+    tui.close();
+  }
+
   // 세션 정리
   handle.kill();
 

package/hub/team/tui.mjs

@@ -0,0 +1,155 @@
+// hub/team/tui.mjs — Zero-dependency TUI 대시보드 (v7.0)
+// handoff 데이터 기반 워커 상태 실시간 ANSI 렌더링
+// 외부 의존성 0 — Node.js 내장 + ansi.mjs만 사용
+
+import {
+  cursorHome, clearLine, cursorHide, cursorShow,
+  RESET, BOLD, DIM, FG, BG,
+  color, dim, truncate, stripAnsi,
+  STATUS_ICON, CLI_ICON,
+} from "./ansi.mjs";
+
+const VERSION = "7.0.0";
+
+/**
+ * TUI 대시보드 생성
+ * @param {object} [opts]
+ * @param {NodeJS.WriteStream} [opts.stream=process.stdout]
+ * @param {number} [opts.refreshMs=1000] — 자동 갱신 주기 (0=수동만)
+ * @param {number} [opts.width=0] — 0이면 터미널 폭 자동
+ * @returns {TuiHandle}
+ */
+export function createTui(opts = {}) {
+  const {
+    stream = process.stdout,
+    refreshMs = 1000,
+    width: fixedWidth = 0,
+  } = opts;
+
+  const workers = new Map();
+  let pipeline = { phase: "exec", fix_attempt: 0 };
+  let startedAt = Date.now();
+  let timer = null;
+  let closed = false;
+  let frameCount = 0;
+
+  function w() { return fixedWidth > 0 ? fixedWidth : (stream.columns || 80); }
+  function out(text) { if (!closed) stream.write(text); }
+
+  // ── 렌더 함수 ──
+
+  function header() {
+    const elapsed = Math.round((Date.now() - startedAt) / 1000);
+    const vals = [...workers.values()];
+    const done = vals.filter((s) => s.status === "completed").length;
+    const fail = vals.filter((s) => s.status === "failed").length;
+    const run  = vals.filter((s) => s.status === "running").length;
+
+    const left = ` ${color("▲ triflux", FG.triflux)} ${dim(`v${VERSION}`)}`;
+    const right = `${color(`${done}✓`, FG.green)} ${color(`${fail}✗`, FG.red)} ${run}⏳ ${dim(`${vals.length}총`)} ${dim(`${elapsed}s`)}`;
+    const gap = Math.max(1, w() - stripAnsi(left).length - stripAnsi(right).length - 1);
+    return `${BG.header}${left}${" ".repeat(gap)}${right}${RESET}`;
+  }
+
+  function workerCard(name, st) {
+    const icon = CLI_ICON[st.cli] || dim("●");
+    const sIcon = STATUS_ICON[st.status] || STATUS_ICON.pending;
+    const el = st.elapsed != null ? `${st.elapsed}s` : "";
+    const role = st.role ? dim(`(${st.role})`) : "";
+    const conf = st.handoff?.confidence ? dim(` ${st.handoff.confidence}`) : "";
+
+    const lines = [];
+    lines.push(`  ${icon} ${st.cli} ${role}  ${sIcon} ${el}${conf}`);
+
+    if (st.handoff?.verdict) {
+      lines.push(`     ${truncate(st.handoff.verdict, w() - 8)}`);
+    }
+
+    if (st.handoff?.files_changed?.length) {
+      const f = st.handoff.files_changed.slice(0, 3).join(", ");
+      const more = st.handoff.files_changed.length > 3 ? ` +${st.handoff.files_changed.length - 3}` : "";
+      lines.push(`     ${dim(`files: ${f}${more}`)}`);
+    }
+
+    if (st.status === "failed" && st.handoff) {
+      const p = [];
+      if (st.handoff.risk) p.push(`risk:${st.handoff.risk}`);
+      if (st.handoff.lead_action) p.push(`action:${st.handoff.lead_action}`);
+      if (p.length) lines.push(`     ${color(p.join(" │ "), FG.red)}`);
+    }
+
+    if (st.status === "running" && st.snapshot) {
+      lines.push(`     ${dim(truncate(st.snapshot, w() - 8))}`);
+    }
+
+    return lines;
+  }
+
+  function pipelineBar() {
+    const phases = ["plan", "prd", "confidence", "exec", "deslop", "verify", "selfcheck", "complete"];
+    const cur = pipeline.phase;
+    const parts = phases.map((p) => {
+      const ci = phases.indexOf(cur);
+      const pi = phases.indexOf(p);
+      if (p === cur) return `${FG.accent}${BOLD}[${p}]${RESET}`;
+      if (pi < ci) return `${FG.green}${p}${RESET}`;
+      return dim(p);
+    });
+    return ` ${parts.join(dim("→"))}`;
+  }
+
+  function footer() {
+    const vals = [...workers.values()];
+    const done = vals.filter((s) => s.status === "completed").length;
+    const tokenSaved = done * 850;
+    return `${BG.header} ${done}✓ 완료 │ ~${tokenSaved} 토큰 절감 ${RESET}`;
+  }
+
+  function render() {
+    if (closed) return;
+    frameCount++;
+    const sep = dim("─".repeat(w()));
+    const buf = [cursorHome];
+
+    buf.push(header() + clearLine + "\n");
+    buf.push(sep + "\n");
+
+    if (workers.size === 0) {
+      buf.push(dim("  (워커 대기 중...)\n"));
+    } else {
+      for (const [name, st] of workers) {
+        for (const l of workerCard(name, st)) buf.push(l + clearLine + "\n");
+        buf.push("\n");
+      }
+    }
+
+    buf.push(sep + "\n");
+    buf.push(pipelineBar() + clearLine + "\n");
+    buf.push(footer() + clearLine + "\n");
+
+    out(buf.join(""));
+  }
+
+  // 자동 갱신
+  if (refreshMs > 0) {
+    timer = setInterval(render, refreshMs);
+    if (timer.unref) timer.unref();
+  }
+
+  return {
+    updateWorker(paneName, state) {
+      const existing = workers.get(paneName) || { cli: "codex", status: "pending" };
+      workers.set(paneName, { ...existing, ...state });
+    },
+    updatePipeline(state) { pipeline = { ...pipeline, ...state }; },
+    setStartTime(ms) { startedAt = ms; },
+    render,
+    getWorkers() { return new Map(workers); },
+    getFrameCount() { return frameCount; },
+    close() {
+      if (closed) return;
+      closed = true;
+      if (timer) clearInterval(timer);
+    },
+  };
+}

package/package.json

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

package/scripts/headless-guard.mjs

@@ -50,7 +50,8 @@ function isPsmuxInstalled() {
 }
 
 /**
- * tfx-route.sh 명령에서 agent, prompt를 파싱한다.
+ * tfx-route.sh 명령에서 agent, prompt, mcp, 추가 플래그를 파싱한다.
+ * v3: 손실 없는 파싱 — 원본 명령의 모든 플래그를 보존.
  */
 function parseRouteCommand(cmd) {
   const MCP_PROFILES = ["implement", "analyze", "review", "docs"];
@@ -79,7 +80,17 @@ function parseRouteCommand(cmd) {
     .replace(/'"'"'/g, "'")
     .trim();
 
-  return { agent, prompt, mcp };
+  // v3: 원본 명령에서 추가 플래그 추출
+  const flags = {};
+  const timeoutMatch = cmd.match(/(?:^|\s)(\d{2,4})(?:\s|$)/);  // 4번째 인자 (timeout)
+  if (timeoutMatch) flags.timeout = parseInt(timeoutMatch[1], 10);
+
+  // 환경변수 기반 글로벌 플래그
+  if (process.env.TFX_DASHBOARD === "1") flags.dashboard = true;
+  if (process.env.TFX_VERBOSE === "1") flags.verbose = true;
+  if (process.env.TFX_NO_AUTO_ATTACH === "1") flags.noAutoAttach = true;
+
+  return { agent, prompt, mcp, flags };
 }
 
 function autoRoute(updatedCommand, reason) {
@@ -143,10 +154,21 @@ async function main() {
       if (parsed) {
         const safePrompt = parsed.prompt.replace(/'/g, "'\\''");
         const VALID_MCP = new Set(["implement", "analyze", "review", "docs"]);
-        const mcpFlag = parsed.mcp && VALID_MCP.has(parsed.mcp) ? ` --mcp-profile ${parsed.mcp}` : "";
+        const f = parsed.flags || {};
+
+        // v3: 플래그 빌더 — 하드코딩 제거, 원본 의도 보존
+        const parts = ["tfx multi --teammate-mode headless"];
+        if (!f.noAutoAttach) parts.push("--auto-attach");
+        if (f.dashboard) parts.push("--dashboard");
+        if (f.verbose) parts.push("--verbose");
+        parts.push(`--assign '${parsed.agent}:${safePrompt}:${parsed.agent}'`);
+        if (parsed.mcp && VALID_MCP.has(parsed.mcp)) parts.push(`--mcp-profile ${parsed.mcp}`);
+        parts.push(`--timeout ${f.timeout || 600}`);
+
+        const builtCmd = parts.join(" ");
         autoRoute(
-          `tfx multi --teammate-mode headless --auto-attach --assign '${parsed.agent}:${safePrompt}:${parsed.agent}'${mcpFlag} --timeout 600`,
-          `[headless-guard] auto-route: tfx-route.sh ${parsed.agent} → headless. mcp=${parsed.mcp}`,
+          builtCmd,
+          `[headless-guard] auto-route: tfx-route.sh ${parsed.agent} → headless. mcp=${parsed.mcp} dashboard=${!!f.dashboard}`,
         );
       }
       deny(